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。

如果发生错误，函数将返回以下返回代码：

返回代码 说明
ERROR_MORE_DATA
 缓冲区太小，无法接收安全描述符。 使用 BufferSize 中返回的大小重新分配缓冲区。

注解

如果注册表中不存在 GUID，ETW 将返回提供程序或控制器的默认权限。 有关在注册表中指定 GUID 的详细信息，请参阅 EventAccessControl。

有关访问安全描述符组件的信息，请参阅 从 ACL 获取信息、 GetSecurityDescriptorDacl、 GetSecurityDescriptorSacl 和 GetAce 函数以及 ACE 结构。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 evntcons.h
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

EventAccessControl

EventAccessRemove