Funzione AuditQuerySecurity (ntsecapi.h)
La funzione AuditQuerySecurity recupera il descrittore di sicurezza che delega l'accesso ai criteri di controllo.
Sintassi
BOOLEAN AuditQuerySecurity(
[in] SECURITY_INFORMATION SecurityInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor
);
Parametri
[in] SecurityInformation
Valore SECURITY_INFORMATION che specifica quali parti del descrittore di sicurezza imposta questa funzione. Sono supportati solo SACL_SECURITY_INFORMATION e DACL_SECURITY_INFORMATION . Tutti gli altri valori vengono ignorati. Se non viene specificato né SACL_SECURITY_INFORMATION né DACL_SECURITY_INFORMATION , questa funzione ha esito negativo e restituisce ERROR_INVALID_PARAMETER.
[out] ppSecurityDescriptor
Indirizzo di un puntatore a una struttura SECURITY_DESCRIPTOR ben formata che controlla l'accesso all'oggetto Di sicurezza Audit.
Valore restituito
Se la funzione ha esito positivo, restituisce TRUE.
Se la funzione ha esito negativo, restituisce FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError. GetLastError può restituire uno dei codici di errore seguenti definiti in WinError.h.
| Codice/valore restituito | Descrizione |
|---|---|
|
Il chiamante non dispone dei privilegi o dei diritti di accesso necessari per chiamare questa funzione. |
|
Uno o più parametri non sono validi. |
Commenti
Per chiamare correttamente questa funzione, il chiamante deve avere SeSecurityPrivilege.
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 | ntsecapi.h |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |