Função EventSetInformation (evntprov.h)
Configura um provedor de eventos ETW.
Sintaxe
ULONG EVNTAPI EventSetInformation(
[in] REGHANDLE RegHandle,
[in] EVENT_INFO_CLASS InformationClass,
[in] PVOID EventInformation,
[in] ULONG InformationLength
);
Parâmetros
[in] RegHandle
Identificador de registro do provedor de eventos. Esse é um identificador retornado por EventRegister.
[in] InformationClass
EVENT_INFO_CLASS valor que especifica a operação de configuração a ser executada no provedor de eventos.
[in] EventInformation
Ponteiro para um buffer que contém dados a serem usados ao configurar o provedor de eventos. O formato dos dados nesse buffer depende do valor especificado no parâmetro InformationClass .
Esse valor poderá ser NULL se InformationLength for zero.
[in] InformationLength
O tamanho (em bytes) dos dados no buffer EventInformation .
Valor retornado
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor retornado será um dos seguintes códigos de erro.
- ERROR_INVALID_PARAMETER: o parâmetro está incorreto. Por exemplo, esse erro será retornado se o parâmetro RegHandle não for um identificador de registro de provedor válido, se EventInformation for NULL , mas InformationLength não for zero ou se o InformationLength especificado não for válido para o InformationClass especificado.
- ERROR_NOT_SUPPORTED: não há suporte para a solicitação. Esse erro será retornado se o parâmetro InformationClass não for um valor reconhecido.
- Outro: use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.
Requisitos
| Cliente mínimo com suporte | Windows 8 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | evntprov.h |
| Biblioteca | Advapi32.lib |
| DLL | Advapi32.dll |