Méthode IWbemEventProviderSecurity ::AccessCheck (wbemprov.h)

La méthode AccessCheck est implémentée par un fournisseur d’événements et appelée par Windows Management Instrumentation (WMI) lorsqu’un consommateur s’abonne à un événement spécifié dans wszQuery. Un consommateur qui dispose d’une autorisation d’accès pour un événement peut s’abonner à cet événement. Un consommateur qui n’a pas d’autorisation d’accès pour un événement ne peut pas s’abonner à cet événement. Pour plus d’informations, consultez Écriture d’un fournisseur d’événements et Sécurisation des événements WMI.

Pour un consommateur temporaire, WMI définit le PSID fourni dans le paramètre pSid sur NULL et l’appel est effectué en empruntant l’identité du consommateur. Pour un consommateur permanent, WMI définit le PSID avec l’identificateur de sécurité (SID) de l’utilisateur qui a créé l’abonnement.

Syntaxe

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

Paramètres

[in] wszQueryLanguage

Langage du filtre de requête suivant, qui est « WQL ».

[in] wszQuery

Texte du filtre de requête d’événement, qui est inscrit par un consommateur logique.

[in] lSidLength

Entier qui contient la longueur de l’identificateur de sécurité (SID), ou 0 (zéro) si le jeton du générateur d’abonnement est disponible.

[in] pSid

Pointeur vers le type entier d’octet constant qui contient le SID, ou NULL si le jeton du générateur d’abonnement est disponible.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique l’état de l’appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

Configuration requise

Voir aussi

IWbemEventProvider

IWbemEventProviderSecurity

Instruction SELECT pour les requêtes d’événements

Sécurisation des événements WMI