AuthzInitializeObjectAccessAuditEvent2 函式 (authz.h)

  • 發行項

AuthzInitializeObjectAccessAuditEvent2 函式會配置並初始化AUTHZ_AUDIT_EVENT_HANDLE句柄，以便與 AuthzAccessCheck 函式搭配使用。

語法

AUTHZAPI BOOL AuthzInitializeObjectAccessAuditEvent2(
  [in]  DWORD                         Flags,
  [in]  AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  [in]  PWSTR                         szOperationType,
  [in]  PWSTR                         szObjectType,
  [in]  PWSTR                         szObjectName,
  [in]  PWSTR                         szAdditionalInfo,
  [in]  PWSTR                         szAdditionalInfo2,
  [out] PAUTHZ_AUDIT_EVENT_HANDLE     phAuditEvent,
  [in]  DWORD                         dwAdditionalParameterCount,
        ...                           
);

參數

[in] Flags

修改稽核行為的旗標。 下表顯示可能的值。

值 意義
AUTHZ_NO_ALLOC_STRINGS
 使用傳遞字串的指標，而不是配置記憶體並複製字串。 呼叫的應用程式必須確保傳遞的記憶體取檢查期間保持有效。
AUTHZ_NO_FAILURE_AUDIT
 停用失敗稽核的產生。
AUTHZ_NO_SUCCESS_AUDIT
 停用成功稽核的產生。

[in] hAuditEventType

保留的。 此參數應該設定為 NULL。

[in] szOperationType

字串的指標，表示要稽核的作業。

[in] szObjectType

字串的指標，表示存取的物件類型。

[in] szObjectName

字串的指標，表示所存取物件的名稱。

[in] szAdditionalInfo

包含其他稽核資訊的 Resource Manager 所定義的字串指標。

[in] szAdditionalInfo2

包含其他稽核資訊的 Resource Manager 所定義的字串指標。

[out] phAuditEvent

傳回 之AUTHZ_AUDIT_EVENT_HANDLE 句柄的指標。

[in] dwAdditionalParameterCount

必須設定為零。

...

其他參數。

傳回值

如果函式成功，則會傳回 TRUE。

如果函式失敗，則會傳回 FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 authz.h
程式庫 Authz.lib
Dll Authz.dll
可轉散發套件 Windows XP 上的 Windows Server 2003 系統管理工具套件

另請參閱

AuthzAccessCheck

基本 存取控制 函式