Funzione AuditQueryGlobalSaclW (ntsecapi.h)

  • Articolo

La funzione AuditQueryGlobalSacl recupera un elenco di controllo di accesso al sistema globale (SACL) che delega l'accesso ai messaggi di controllo. L'aggiornamento di SACL globale richiede seSecurityPrivilege che protegge il SACL globale da aggiornare da 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 specificando 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 contenente 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 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.

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

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