Funzione AuditSetPerUserPolicy (ntsecapi.h)

Articolo
03/09/2024

La funzione AuditSetPerUserPolicy imposta i criteri di controllo per utente in una o più sottocategorie di controllo per l'entità specificata.

Sintassi

BOOLEAN AuditSetPerUserPolicy(
  [in] const PSID                 pSid,
  [in] PCAUDIT_POLICY_INFORMATION pAuditPolicy,
  [in] ULONG                      dwPolicyCount
);

Parametri

[in] pSid

Puntatore alla struttura SID associata all'entità per cui impostare i criteri di controllo. I criteri per utente per i SID di gruppo non sono attualmente supportati.

[in] pAuditPolicy

Puntatore a una matrice di strutture AUDIT_POLICY_INFORMATION . Ogni struttura specifica i criteri di controllo per utente per una sottocategoria di controllo.

Il membro AuditCategoryGuid di queste strutture viene ignorato.

[in] dwPolicyCount

Numero di elementi nella matrice pAuditPolicy .

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.
ERROR_NO_SUCH_USER 1317	La struttura SID specificata dal parametro pSID non è associata a un utente esistente.

Commenti

Per chiamare correttamente questa funzione, il chiamante deve avere SeSecurityPrivilege o avere accesso AUDIT_SET_USER_POLICYsull'oggetto sicurezza Audit.

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

AuditQueryPerUserPolicy

AuditQuerySystemPolicy

AuditSetSystemPolicy

Share via