EventAccessQuery, fonction (evntcons.h)

  • Article

Récupère les autorisations pour le contrôleur ou le fournisseur spécifié.

Syntaxe

ULONG EVNTAPI EventAccessQuery(
  [in]      LPGUID               Guid,
  [in, out] PSECURITY_DESCRIPTOR Buffer,
  [in, out] PULONG               BufferSize
);

Paramètres

[in] Guid

GUID qui identifie de manière unique le fournisseur ou la session.

[in, out] Buffer

Mémoire tampon allouée par l’application qui contiendra le descripteur de sécurité du contrôleur ou du fournisseur.

[in, out] BufferSize

Taille de la mémoire tampon de descripteur de sécurité, en octets. Si la fonction réussit, ce paramètre reçoit la taille de la mémoire tampon utilisée. Si la mémoire tampon est trop petite, la fonction retourne ERROR_MORE_DATA et ce paramètre reçoit la taille de mémoire tampon requise. Si la taille de la mémoire tampon est égale à zéro à l’entrée, aucune donnée n’est retournée dans la mémoire tampon et ce paramètre reçoit la taille de mémoire tampon requise.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite.

La fonction retourne le code de retour suivant si une erreur se produit :

Code de retour Description
ERROR_MORE_DATA
 La mémoire tampon est trop petite pour recevoir le descripteur de sécurité. Réallouer la mémoire tampon à l’aide de la taille retournée dans BufferSize.

Remarques

Si le GUID n’existe pas dans le Registre, ETW retourne les autorisations par défaut pour un fournisseur ou un contrôleur. Pour plus d’informations sur la spécification du GUID dans le Registre, consultez EventAccessControl.

Pour plus d’informations sur l’accès aux composants du descripteur de sécurité, consultez Obtention d’informations à partir d’une liste de contrôle d’accès, des fonctions GetSecurityDescriptorDacl, GetSecurityDescriptorSacl et GetAce , et la structure ACE .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête evntcons.h
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

EventAccessControl

EventAccessRemove