Função UnregisterTraceGuids (evntrace.h)

  • Artigo

A função UnregisterTraceGuids cancela o registro de um provedor de rastreamento de eventos ETW clássico (estilo Windows 2000) que foi registrado usando RegisterTraceGuids.

Sintaxe

ULONG WMIAPI UnregisterTraceGuids(
  [in] TRACEHANDLE RegistrationHandle
);

Parâmetros

[in] RegistrationHandle

Manipule para o provedor de rastreamento de eventos, obtido de uma chamada anterior para a função RegisterTraceGuids .

Retornar valor

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um dos códigos de erro do sistema. Veja a seguir alguns erros comuns e suas causas.

  • ERROR_INVALID_PARAMETER

    O parâmetro RegistrationHandle não especifica o identificador para um provedor registrado ou é NULL.

Comentários

Os provedores chamam essa função.

O provedor de rastreamento de eventos deve ter sido registrado anteriormente chamando a função RegisterTraceGuids .

Importante

Todos os identificadores de registro criados por uma DLL ou driver devem ser cancelados antes que a DLL ou o driver seja descarregado. Se o provedor não for cancelado, ocorrerá uma falha quando o ETW tentar invocar o retorno de chamada do provedor.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho evntrace.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

RegisterTraceGuids