ObjectDeleteAuditAlarmW-Funktion (securitybaseapi.h)

Artikel
03/01/2024

Die ObjectDeleteAuditAlarm-Funktion generiert Überwachungsmeldungen, wenn ein Objekt gelöscht wird. Alarme werden derzeit nicht unterstützt.

Syntax

BOOL ObjectDeleteAuditAlarmW(
  [in] LPCWSTR SubsystemName,
  [in] LPVOID  HandleId,
  [in] BOOL    GenerateOnClose
);

Parameter

[in] SubsystemName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Subsystems angibt, das die Funktion aufruft. Diese Zeichenfolge wird in jeder Überwachungsmeldung angezeigt, die von der Funktion generiert wird.

[in] HandleId

Gibt einen eindeutigen Wert an, der das Handle des Clients für das -Objekt darstellt. Dies muss derselbe Wert sein, der an die AccessCheckAndAuditAlarm - oder ObjectOpenAuditAlarm-Funktion übergeben wurde.

[in] GenerateOnClose

Gibt ein Flag an, das durch einen Aufruf der AccessCheckAndAuditAlarm - oder ObjectOpenAuditAlarm-Funktion festgelegt wird, wenn das Objekthandle erstellt wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die ObjectDeleteAuditAlarm-Funktion erfordert, dass die aufrufende Anwendung die berechtigung SE_AUDIT_NAME aktiviert hat. Der Test für diese Berechtigung wird immer für das primäre Token des aufrufenden Prozesses durchgeführt, sodass der aufrufende Prozess die Identität eines Clients annehmen kann.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (Einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

AccessCheck
AccessCheckAndAuditAlarm
AreAllAccessesGranted
AreAnyAccessesGranted
Client/Server-Access Control
Client-/Server-Access Control-Funktionen
MapGenericMask
ObjectCloseAuditAlarm
ObjectOpenAuditAlarm
ObjectPrivilegeAuditAlarm
PrivilegeCheck
PrivilegedServiceAuditAlarm

Freigeben über