Función EventSetInformation (evntprov.h)

Configura un proveedor de eventos ETW.

Sintaxis

ULONG EVNTAPI EventSetInformation(
  [in] REGHANDLE        RegHandle,
  [in] EVENT_INFO_CLASS InformationClass,
  [in] PVOID            EventInformation,
  [in] ULONG            InformationLength
);

Parámetros

[in] RegHandle

Identificador de registro del proveedor de eventos. Se trata de un identificador devuelto por EventRegister.

[in] InformationClass

EVENT_INFO_CLASS valor que especifica la operación de configuración que se va a realizar en el proveedor de eventos.

[in] EventInformation

Puntero a un búfer que contiene los datos que se van a usar al configurar el proveedor de eventos. El formato de los datos de este búfer depende del valor especificado en el parámetro InformationClass .

Este valor puede ser NULL si InformationLength es cero.

[in] InformationLength

Tamaño (en bytes) de los datos en el búfer EventInformation .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

• ERROR_INVALID_PARAMETER: el parámetro es incorrecto. Por ejemplo, este error se devuelve si el parámetro RegHandle no es un identificador de registro de proveedor válido, si EventInformation es NULL , pero InformationLength es distinto de cero o si informationLength especificado no es válido para la clase InformationClass especificada.
• ERROR_NOT_SUPPORTED: no se admite la solicitud. Este error se devuelve si el parámetro InformationClass no es un valor reconocido.
• Otro: use FormatMessage para obtener la cadena de mensaje para el error devuelto.

Requisitos

Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	evntprov.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll

Consulte también

EVENT_INFO_CLASS

EventRegister