Funzione AuditSetPerUserPolicy (ntsecapi.h)

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