Función EventAccessQuery (evntcons.h)

Recupera los permisos para el controlador o proveedor especificados.

Sintaxis

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

Parámetros

[in] Guid

GUID que identifica de forma única el proveedor o la sesión.

[in, out] Buffer

Búfer asignado a la aplicación que contendrá el descriptor de seguridad del controlador o proveedor.

[in, out] BufferSize

Tamaño del búfer del descriptor de seguridad, en bytes. Si la función se ejecuta correctamente, este parámetro recibe el tamaño del búfer usado. Si el búfer es demasiado pequeño, la función devuelve ERROR_MORE_DATA y este parámetro recibe el tamaño de búfer necesario. Si el tamaño del búfer es cero en la entrada, no se devuelve ningún dato en el búfer y este parámetro recibe el tamaño de búfer necesario.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente.

La función devuelve el siguiente código de retorno si se produce un error:

Código devuelto	Descripción
ERROR_MORE_DATA	El búfer es demasiado pequeño para recibir el descriptor de seguridad. Reasignar el búfer con el tamaño devuelto en BufferSize.

Comentarios

Si el GUID no existe en el Registro, ETW devuelve los permisos predeterminados para un proveedor o controlador. Para obtener más información sobre cómo especificar el GUID en el registro, consulte EventAccessControl.

Para obtener información sobre el acceso a los componentes del descriptor de seguridad, vea Obtener información de una ACL, las funciones GetSecurityDescriptorDacl, GetSecurityDescriptorSacl y GetAce , y la estructura ACE .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	evntcons.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll

Consulte también

EventAccessControl

EventAccessRemove