Funzione AuditSetGlobalSaclA (ntsecapi.h)

  • Articolo

La funzione AuditSetGlobalSacl imposta 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 l'elenco SACL globale dall'aggiornamento da parte di qualsiasi utente senza privilegi di amministratore.

Sintassi

BOOLEAN AuditSetGlobalSaclA(
  [in]           PCSTR ObjectTypeName,
  [in, optional] PACL  Acl
);

Parametri

[in] ObjectTypeName

Puntatore a una stringa con terminazione Null che specifica il tipo di oggetto in fase di creazione o accesso. Per impostare sacl globale nei file, questa impostazione deve essere impostata su "File" e per impostare l'elenco SACL globale nel Registro di sistema, questa impostazione deve essere impostata su "Key". Questa stringa viene visualizzata in qualsiasi messaggio di controllo generato dalla funzione.

[in, optional] Acl

Puntatore a una struttura ACL .

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 AuditSetGlobalSacl 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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