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 |
|---|---|
|
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 |