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 |
|---|---|
|
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 |