SetTraceCallback 함수(evntrace.h)

중요

이 함수를 사용하지 마세요. 후속 버전에서는 사용할 수 없습니다. 대신 EventRecordCallback 함수에서 이벤트 추적 클래스를 필터링합니다.

SetTraceCallback 함수는 지정된 이벤트 추적 클래스에 대한 이벤트를 처리하는 EventCallback 함수를 지정합니다.

구문

ULONG WMIAPI SetTraceCallback(
  [in] LPCGUID         pGuid,
  [in] PEVENT_CALLBACK EventCallback
);

[in] pGuid

이벤트를 수신하려는 이벤트 추적 클래스의 클래스 GUID에 대한 포인터입니다. 커널 공급자 클래스 GUID 목록은 NT 커널 로거 상수를 참조하세요.

[in] EventCallback

이벤트 추적 클래스에 속하는 이벤트를 처리하는 데 사용되는 EventCallback 함수에 대한 포인터입니다.

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

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

ERROR_INVALID_PARAMETER

다음 중 하나에 해당합니다.
- pGuid 가 NULL입니다.
- EventCallback 은 NULL입니다.

소비자는 이 함수를 호출합니다.

이벤트 추적 클래스에 대해 하나의 콜백 함수만 지정할 수 있습니다. 이벤트 추적 클래스에 대해 둘 이상의 콜백 함수를 지정하는 경우 마지막 콜백 함수는 해당 이벤트 추적 클래스에 대한 이벤트를 수신합니다.

콜백 함수가 이벤트 추적 클래스에 대한 이벤트를 수신하지 못하도록 하려면 RemoveTraceCallback 함수를 호출합니다. 추적을 닫으면 콜백 수신이 자동으로 중지됩니다.

이 함수를 사용하여 TraceEvent 함수 중 하나를 사용하여 작성된 이벤트를 받을 수 있습니다. EventWrite 함수 중 하나를 사용하여 이벤트를 기록하는 공급자의 이벤트를 사용하는 데는 이 함수를 사용할 수 없습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	evntrace.h
라이브러리	Windows 8.1 및 Windows Server 2012 R2의 Sechost.lib; Advapi32.lib on Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista 및 Windows XP
DLL	Windows 8.1 및 Windows Server 2012 R2의 Sechost.dll, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista 및 Windows XP에서 Advapi32.dll