UnregisterTraceGuids 함수(evntrace.h)

  • 아티클

UnregisterTraceGuids 함수는 RegisterTraceGuids를 사용하여 등록된 클래식(Windows 2000 스타일) ETW 이벤트 추적 공급자의 등록을 취소합니다.

구문

ULONG WMIAPI UnregisterTraceGuids(
  [in] TRACEHANDLE RegistrationHandle
);

매개 변수

[in] RegistrationHandle

RegisterTraceGuids 함수에 대한 이전 호출에서 가져온 이벤트 추적 공급자에 대한 핸들입니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 시스템 오류 코드 중 하나입니다. 다음은 몇 가지 일반적인 오류와 그 원인입니다.

  • ERROR_INVALID_PARAMETER

    RegistrationHandle 매개 변수는 등록된 공급자에 대한 핸들을 지정하지 않거나 NULL입니다.

설명

공급자는 이 함수를 호출합니다.

이벤트 추적 공급자는 RegisterTraceGuids 함수를 호출하여 이전에 등록되어 있어야 합니다.

중요

DLL 또는 드라이버에서 만든 모든 등록 핸들은 DLL 또는 드라이버가 언로드되기 전에 등록을 취소해야 합니다. 공급자가 등록 취소되지 않은 경우 ETW가 공급자의 콜백을 호출하려고 할 때 충돌이 발생합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 evntrace.h
라이브러리 Advapi32.lib
DLL Advapi32.dll

추가 정보

RegisterTraceGuids