AuditSetPerUserPolicy-Funktion (ntsecapi.h)

  • Artikel

Die AuditSetPerUserPolicy-Funktion legt die Überwachungsrichtlinie pro Benutzer in mindestens einer Überwachungsunterkategorie für den angegebenen Prinzipal fest.

Syntax

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

Parameter

[in] pSid

Ein Zeiger auf die SID-Struktur , die dem Prinzipal zugeordnet ist, für den die Überwachungsrichtlinie festgelegt werden soll. Benutzerspezifische Richtlinien für Gruppen-SIDs werden derzeit nicht unterstützt.

[in] pAuditPolicy

Ein Zeiger auf ein Array von AUDIT_POLICY_INFORMATION Strukturen. Jede Struktur gibt die Überwachungsrichtlinie pro Benutzer für eine Überwachungsunterkategorie an.

Das AuditCategoryGuid-Element dieser Strukturen wird ignoriert.

[in] dwPolicyCount

Die Anzahl der Elemente im pAuditPolicy-Array .

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück.

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError gibt möglicherweise einen der folgenden Fehlercodes zurück, die in WinError.h definiert sind.

Rückgabecode/-wert BESCHREIBUNG
ERROR_ACCESS_DENIED
5
 Der Aufrufer verfügt nicht über die Berechtigungen oder Zugriffsrechte, die zum Aufrufen dieser Funktion erforderlich sind.
ERROR_INVALID_PARAMETER
87
 Mindestens ein Parameter ist ungültig.
ERROR_NO_SUCH_USER
1317
 Die durch den pSID-Parameter angegebene SID-Struktur ist keinem vorhandenen Benutzer zugeordnet.

Hinweise

Um diese Funktion erfolgreich aufzurufen, muss der Aufrufer über SeSecurityPrivilege verfügen oder über AUDIT_SET_USER_POLICY Zugriff auf das Überwachungssicherheitsobjekt verfügen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntsecapi.h
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

AuditQueryPerUserPolicy

AuditQuerySystemPolicy

AuditSetSystemPolicy