CSacl::AddAuditAce

Artikel
02/26/2013

Fügt einen Überwachungszugriffssteuerungseintrag (ACE) dem CSacl-Objekt hinzu.

bool AddAuditAce(
   const CSid & rSid,
   ACCESS_MASK AccessMask,
   bool bSuccess,
   bool bFailure,
   BYTE AceFlags = 0
) throw(...);
bool AddAuditAce(
   const CSid & rSid,
   ACCESS_MASK AccessMask,
   bool bSuccess,
   bool bFailure,
   BYTE AceFlags,
   const GUID * pObjectType,
   const GUID * pInheritedObjectType 
) throw(...);

Parameter

rSid
Das CSid-Objekt.
AccessMask
Gibt die Maske von Zugriffsrechten, für das angegebene Objekt CSid überwacht werden.
bSuccess
Gibt an, ob zulässigen Zugriffsversuche überwacht werden sollen.Legen Sie dieses Flag fest, um auszurichten, um Überwachung zu aktivieren, Legen Sie sie andernfalls false fest.
bFailure
Gibt an, ob verweigerten Zugriffsversuche überwacht werden sollen.Legen Sie dieses Flag fest, um auszurichten, um Überwachung zu aktivieren, Legen Sie sie andernfalls false fest.
AceFlags
Ein Satz von Bitflags, die ACE-Vererbung steuern.
pObjectType
Der Objekttyp.
pInheritedObjectType
Der geerbte Objekttyp.

Rückgabewert

Gibt true, wenn ACE zum CSacl-Objekt hinzugefügt wird, false auf Fehler zurück.

Hinweise

Ein Objekt CSacl enthält Einträge für die Zugriffssteuerung (ACEs) die die Typen der Zugriffsversuchen angeben, die Überwachungsdatensätze im Sicherheitsereignisprotokoll generieren.Diese Methode fügt ein solches ACE dem CSacl-Objekt hinzu.Das zweite Format von AddAuditAce ist unter Windows 2000 und höher nur verfügbar.

Siehe ACE_HEADER für eine Beschreibung der verschiedenen Flags, die im AceFlags-Parameter festgelegt werden können.