Share via

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、GetSecurityDescriptorSacl 和 GetAce 函式，以及 ACE 結構。

規格需求

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

另請參閱

EventAccessControl

EventAccessRemove