Funzione AuditQuerySecurity (ntsecapi.h)

  • Articolo

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
ERROR_ACCESS_DENIED
5
 Il chiamante non dispone dei privilegi o dei diritti di accesso necessari per chiamare questa funzione.
ERROR_INVALID_PARAMETER
87
 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

Vedi anche

AuditSetSecurity