Funzione AuditSetGlobalSaclW (ntsecapi.h)

Articolo
11/20/2024

La funzione AuditSetGlobalSacl imposta 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 AuditSetGlobalSaclW(
  [in]           PCWSTR ObjectTypeName,
  [in, optional] PACL   Acl
);

Parametri

[in] ObjectTypeName

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

[in, optional] Acl

Puntatore a una struttura ACL di .

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 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 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