Функция UnregisterTraceGuids (evntrace.h)

  • Статья

Функция UnregisterTraceGuids отменяет регистрацию поставщика трассировки событий Трассировки событий Windows классического (в стиле Windows 2000), зарегистрированного с помощью RegisterTraceGuids.

Синтаксис

ULONG WMIAPI UnregisterTraceGuids(
  [in] TRACEHANDLE RegistrationHandle
);

Параметры

[in] RegistrationHandle

Дескриптор поставщика трассировки событий, полученный из предыдущего вызова функции RegisterTraceGuids .

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение является одним из кодов системных ошибок. Ниже приведены некоторые распространенные ошибки и их причины.

  • ERROR_INVALID_PARAMETER

    Параметр RegistrationHandle не указывает дескриптор для зарегистрированного поставщика или имеет значение NULL.

Комментарии

Поставщики вызывают эту функцию.

Поставщик трассировки событий должен быть зарегистрирован ранее путем вызова функции RegisterTraceGuids .

Важно!

Все дескрипторы регистрации, созданные библиотекой DLL или драйвером, должны быть отменены до выгрузки библиотеки DLL или драйвера. Если поставщик не отменен, произойдет сбой при попытке трассировки событий Windows вызвать обратный вызов поставщика.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header evntrace.h
Библиотека Advapi32.lib
DLL Advapi32.dll

См. также раздел

RegisterTraceGuids