Funzione AuditQueryGlobalSaclW (ntsecapi.h)

Articolo
11/20/2024

La funzione AuditQueryGlobalSacl recupera un elenco di controllo di accesso di sistema globale (SACL) che delega l'accesso ai messaggi di controllo. L'aggiornamento dell'elenco SACL globale richiede l'SeSecurityPrivilege che protegge l'elenco SACL globale dall'aggiornamento da parte di qualsiasi utente senza privilegi di amministratore.

Sintassi

BOOLEAN AuditQueryGlobalSaclW(
  [in]  PCWSTR ObjectTypeName,
  [out] PACL   *Acl
);

Parametri

[in] ObjectTypeName

Puntatore a una stringa con terminazione Null che specifica il tipo di oggetto a cui si accede. Questo parametro deve essere "File" o "Key", a seconda che l'oggetto sia un file o un registro. Questa stringa viene visualizzata in qualsiasi messaggio di controllo generato dalla funzione.

[out] Acl

Puntatore a una struttura ACL che contiene le informazioni SACL. Questa operazione deve essere liberata in un secondo momento chiamando la funzione LocalFree.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE.

Se la funzione non riesce, restituisce FALSE. Per ottenere informazioni estese 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.

Osservazioni

Per chiamare correttamente questa funzione, il chiamante deve avere SeSecurityPrivilege.

Nota

L'intestazione ntsecapi.h definisce AuditQueryGlobalSacl come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7 [solo app desktop]
server minimo supportato	Windows Server 2008 R2 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ntsecapi.h
libreria	Advapi32.lib
dll	Advapi32.dll

Condividi tramite