AuditSetPerUserPolicy-Funktion (ntsecapi.h)
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 |
|---|---|
|
Der Aufrufer verfügt nicht über die Berechtigungen oder Zugriffsrechte, die zum Aufrufen dieser Funktion erforderlich sind. |
|
Mindestens ein Parameter ist ungültig. |
|
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 |