IWbemEventProviderSecurity::AccessCheck-Methode (wbemprov.h)

Artikel
03/06/2024

Die AccessCheck-Methode wird von einem Ereignisanbieter implementiert und von der Windows-Verwaltungsinstrumentation (WMI) aufgerufen, wenn ein Consumer ein in wszQuery angegebenes Ereignis abonniert. Ein Consumer, der über Zugriffsberechtigungen für ein Ereignis verfügt, kann dieses Ereignis abonnieren. Ein Consumer, der über keine Zugriffsberechtigung für ein Ereignis verfügt, kann dieses Ereignis nicht abonnieren. Weitere Informationen finden Sie unter Schreiben eines Ereignisanbieters und Sichern von WMI-Ereignissen.

Für einen temporären Consumer legt WMI die im pSid-Parameter angegebene PSID auf NULL fest, und der Aufruf erfolgt durch Annehmen der Identität des Consumers. Für einen permanenten Consumer legt WMI die PSID mit der Sicherheits-ID (SID) des Benutzers fest, der das Abonnement erstellt hat.

Syntax

HRESULT AccessCheck(
  [in] WBEM_CWSTR wszQueryLanguage,
  [in] WBEM_CWSTR wszQuery,
  [in] long       lSidLength,
  [in] const BYTE *pSid
);

Parameter

[in] wszQueryLanguage

Die Sprache des folgenden Abfragefilters, der "WQL" ist.

[in] wszQuery

Text des Ereignisabfragefilters, der von einem logischen Consumer registriert wird.

[in] lSidLength

Eine ganze Zahl, die die Länge der Sicherheits-ID (SID) oder 0 (null) enthält, wenn das Token des Abonnement-Generators verfügbar ist.

[in] pSid

Zeiger auf den konstanten Byte-Ganzzahltyp, der die SID enthält, oder NULL , wenn das Token des Abonnement-Generators verfügbar ist.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemprov.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Wbemsvc.dll

Weitere Informationen

IWbemEventProvider

IWbemEventProviderSecurity

SELECT-Anweisung für Ereignisabfragen

Schützen von WMI-Ereignissen

Share via