AuditEnumeratePerUserPolicy-Funktion (ntsecapi.h)

  • Artikel

Die AuditEnumeratePerUserPolicy-Funktion listet Benutzer auf, für die die Überwachungsrichtlinie pro Benutzer angegeben ist.

Syntax

BOOLEAN AuditEnumeratePerUserPolicy(
  [out] PPOLICY_AUDIT_SID_ARRAY *ppAuditSidArray
);

Parameter

[out] ppAuditSidArray

Ein Zeiger auf einen einzelnen Puffer, der sowohl ein Array von Zeigern auf POLICY_AUDIT_SID_ARRAY Strukturen als auch die Strukturen selbst enthält. Die POLICY_AUDIT_SID_ARRAY Strukturen geben die Benutzer an, für die die Überwachungsrichtlinie pro Benutzer angegeben ist.

Wenn Sie mit der Verwendung dieses Puffers fertig sind, geben Sie ihn frei, indem Sie die AuditFree-Funktion aufrufen.

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