AuditSetSystemPolicy-Funktion (ntsecapi.h)

Die AuditSetSystemPolicy-Funktion legt die Systemüberwachungsrichtlinie für mindestens eine Audit-Policy-Unterkategorie fest.

Syntax

BOOLEAN AuditSetSystemPolicy(
  [in] PCAUDIT_POLICY_INFORMATION pAuditPolicy,
  [in] ULONG                      dwPolicyCount
);

Parameter

[in] pAuditPolicy

Ein Zeiger auf ein Array von AUDIT_POLICY_INFORMATION Strukturen. Jede Struktur gibt die Systemüberwachungsrichtlinie für eine Unterkategorie audit-policy an.

Der AuditCategoryGuid-Member dieser Strukturen wird ignoriert.

[in] dwPolicyCount

Die Anzahl der Elemente im pAuditPolicy-Array .

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE zurückgegeben.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. 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.

Hinweise

Um diese Funktion erfolgreich aufzurufen, muss der Aufrufer über SeSecurityPrivilege oder über AUDIT_SET_SYSTEM_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

AuditSetPerUserPolicy