Funzione EventAccessQuery (evntcons.h)

Recupera le autorizzazioni per il controller o il provider specificato.

Sintassi

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

Parametri

[in] Guid

GUID che identifica in modo univoco il provider o la sessione.

[in, out] Buffer

Buffer allocato dall'applicazione che conterrà il descrittore di sicurezza del controller o del provider.

[in, out] BufferSize

Dimensioni del buffer del descrittore di sicurezza, in byte. Se la funzione ha esito positivo, questo parametro riceve le dimensioni del buffer usato. Se il buffer è troppo piccolo, la funzione restituisce ERROR_MORE_DATA e questo parametro riceve le dimensioni del buffer necessarie. Se la dimensione del buffer è zero nell'input, nel buffer non vengono restituiti dati e questo parametro riceve le dimensioni del buffer necessarie.

Valore restituito

Restituisce ERROR_SUCCESS in caso di esito positivo.

Se si verifica un errore, la funzione restituisce il codice restituito seguente:

Codice restituito Descrizione
ERROR_MORE_DATA
Il buffer è troppo piccolo per ricevere il descrittore di sicurezza. Riallocare il buffer usando le dimensioni restituite in BufferSize.

Commenti

Se il GUID non esiste nel Registro di sistema, ETW restituisce le autorizzazioni predefinite per un provider o un controller. Per informazioni dettagliate sulla specifica del GUID nel Registro di sistema, vedere EventAccessControl.

Per informazioni sull'accesso ai componenti del descrittore di sicurezza, vedere Ottenere informazioni da un elenco di controllo di accesso, le funzioni GetSecurityDescriptorDacl, GetSecurityDescriptorSacl e GetAce e la struttura ACE .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione evntcons.h
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

EventAccessControl

EventAccessRemove