ObjectDeleteAuditAlarmA-Funktion (winbase.h)

Artikel
03/06/2024

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

Syntax

BOOL ObjectDeleteAuditAlarmA(
  [in] LPCSTR SubsystemName,
  [in] LPVOID HandleId,
  [in] BOOL   GenerateOnClose
);

Parameter

[in] SubsystemName

Ein Zeiger auf eine NULL-beendete 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 der gleiche 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 Nichtzero-Wert.

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	winbase.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll