Função UnregisterTraceGuids (evntrace.h)
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] TRACEGUID_HANDLE 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 |