Função EventSetInformation (evntprov.h)

  • Artigo

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

Confira também

EVENT_INFO_CLASS

EventRegister