ObjectCloseAuditAlarmW 函式 (securitybaseapi.h)

當刪除私人物件的句柄時， ObjectCloseAuditAlarm 函式會在安全性事件記錄檔中產生稽核訊息。目前不支援警示。

語法

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

[in] SubsystemName

指定呼叫函式之子系統名稱之 Null 終止字串的指標。此字串會出現在函式產生的任何稽核訊息中。

[in] HandleId

唯一值，表示客戶端對物件的句柄。這應該是傳遞至 AccessCheckAndAuditAlarm 或 ObjectOpenAuditAlarm 函式的相同值。

[in] GenerateOnClose

指定建立物件句柄時，呼叫 AccessCheckAndAuditAlarm 或 ObjectCloseAuditAlarm 函式所設定的旗標。如果此旗標為 TRUE，函式會產生稽核訊息。如果是 FALSE，函式就不會產生稽核訊息。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

ObjectCloseAuditAlarm 函式需要呼叫的應用程式啟用SE_AUDIT_NAME許可權。此許可權的測試一律會針對呼叫進程的主要令牌執行，讓呼叫進程模擬用戶端

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	securitybaseapi.h (包括 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll