ObjectOpenAuditAlarmA 函式 (winbase.h)

發行項
03/03/2024

當用戶端應用程式嘗試取得物件的存取權或建立新的物件時， ObjectOpenAuditAlarm 函式會產生稽核訊息。目前不支援警示。

語法

BOOL ObjectOpenAuditAlarmA(
  [in]           LPCSTR               SubsystemName,
  [in]           LPVOID               HandleId,
  [in]           LPSTR                ObjectTypeName,
  [in, optional] LPSTR                ObjectName,
  [in]           PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]           HANDLE               ClientToken,
  [in]           DWORD                DesiredAccess,
  [in]           DWORD                GrantedAccess,
  [in, optional] PPRIVILEGE_SET       Privileges,
  [in]           BOOL                 ObjectCreation,
  [in]           BOOL                 AccessGranted,
  [out]          LPBOOL               GenerateOnClose
);

參數

[in] SubsystemName

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

[in] HandleId

唯一值的指標，表示客戶端對物件的句柄。如果拒絕存取，則會忽略此參數。

為了跨平臺相容性，此指標所尋址的值必須是long (LPVOID) 位元組大小。

[in] ObjectTypeName

以 Null 終止之字串的指標，指定用戶端要求存取的物件類型。此字串會出現在函式產生的任何稽核訊息中。

[in, optional] ObjectName

指定用戶端要求存取之物件名稱之 Null 終止字串的指標。此字串會出現在函式產生的任何稽核訊息中。

[in] pSecurityDescriptor

所存取物件的 SECURITY_DESCRIPTOR 結構的指標。

[in] ClientToken

識別存取令牌，表示要求作業的用戶端。您必須開啟模擬用戶端之線程的令牌，以取得此句柄。令牌必須開啟，才能TOKEN_QUERY存取。

[in] DesiredAccess

指定所需的存取遮罩。 MapGenericMask 函式先前必須對應此遮罩，才能不包含泛型訪問許可權。

[in] GrantedAccess

指定存取遮罩，指出授與哪些訪問許可權。此存取掩碼是要與其 GrantedAccess 參數中的其中一個存取檢查函式所設定的值相同。存取檢查函式的範例包括 AccessCheckAndAuditAlarm 和 AccessCheck。

[in, optional] Privileges

PRIVILEGE_SET 結構的指標，指定存取嘗試所需的一組許可權。此參數可以是 Null。

[in] ObjectCreation

指定旗標，這個旗標會決定應用程式是否在授與存取權時建立新的物件。當此值為 TRUE時，應用程式會建立新的物件;當它是 FALSE 時，應用程式會開啟現有的物件。

[in] AccessGranted

指定旗標，指出先前對 Access-checking 函式的呼叫是否授與或拒絕存取權，例如 AccessCheck。如果已授與存取權，則此值為 TRUE。如果沒有，則為 FALSE。

[out] GenerateOnClose

函式傳回時，稽核產生例程所設定旗標的指標。關閉物件句柄時，此值必須傳遞至 ObjectCloseAuditAlarm 函式。

傳回值

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

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

備註

ObjectOpenAuditAlarm 函式需要呼叫的應用程式啟用SE_AUDIT_NAME許可權。此許可權的測試一律會針對呼叫進程的主要令牌執行，而不是線程的模擬令牌。這可讓呼叫進程在呼叫期間模擬用戶端。

規格需求

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