共用方式為


EventAccessQuery 函式 (evntcons.h)

擷取指定之控制器或提供者的許可權。

語法

ULONG EVNTAPI EventAccessQuery(
  [in]      LPGUID               Guid,
  [in, out] PSECURITY_DESCRIPTOR Buffer,
  [in, out] PULONG               BufferSize
);

參數

[in] Guid

可唯一識別提供者或會話的 GUID。

[in, out] Buffer

將包含控制器或提供者之安全性描述元的應用程式配置緩衝區。

[in, out] BufferSize

安全性描述元緩衝區的大小,以位元組為單位。 如果函式成功,此參數會接收所使用的緩衝區大小。 如果緩衝區太小,函式會傳回ERROR_MORE_DATA,而且此參數會收到所需的緩衝區大小。 如果輸入上的緩衝區大小為零,則緩衝區中不會傳回任何數據,而且此參數會收到所需的緩衝區大小。

傳回值

如果成功,則傳回ERROR_SUCCESS。

如果發生錯誤,此函式會傳回下列傳回碼:

傳回碼 Description
ERROR_MORE_DATA
緩衝區太小,無法接收安全性描述元。 使用 BufferSize 中傳回的大小來重新配置緩衝區。

備註

如果登錄中不存在 GUID,ETW 會傳回提供者或控制器的預設許可權。 如需在登錄中指定 GUID 的詳細資訊,請參閱 EventAccessControl

如需存取安全性描述元元件的資訊,請參閱從 ACL 取得資訊GetSecurityDescriptorDacl、GetSecurityDescriptorSaclGetAce 函式,以及 ACE 結構。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 evntcons.h
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

EventAccessControl

EventAccessRemove