IDebugClient3::SetEventCallbacks 메서드(dbgeng.h)

아티클
02/23/2024

SetEventCallbacks 메서드는 이 클라이언트에 이벤트 콜백 개체를 등록합니다.

구문

HRESULT SetEventCallbacks(
  [in, optional] PDEBUG_EVENT_CALLBACKS Callbacks
);

매개 변수

[in, optional] Callbacks

이 클라이언트에 등록할 이벤트 콜백 개체에 대한 인터페이스 포인터를 지정합니다.

반환 값

콜백으로 지정된 개체에서 IDebugEventCallbacks::GetInterestMask 메서드의 구현에 따라 주의 섹션에 설명된 대로 다른 값이 반환될 수 있습니다.

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.

설명

콜백 값이 NULL이 아니면 IDebugEventCallbacks::GetInterestMask 메서드가 호출됩니다. 반환 값이 S_OK 않으면 SetEventCallbacks 및 SetEventCallbacksWide 는 아무런 효과가 없으며 이 값을 반환합니다.

각 클라이언트에는 이벤트 수신을 위해 IDebugEventCallbacks 또는 IDebugEventCallbacksWide 개체가 하나 이상 등록되어 있을 수 있습니다.

IDebugEventCallbacks 인터페이스는 COM 인터페이스 IUnknown을 확장합니다. SetEventCallbacks 및 SetEventCallbacksWide가 성공하면 콜백으로 지정된 개체의 IUnknown::AddRef 메서드를 호출합니다. 이 개체의 IUnknown::Release 메서드는 다음에 이 클라이언트에서 SetEventCallbacks 또는SetEventCallbacksWide 가 호출되거나 이 클라이언트가 삭제될 때 호출됩니다.

콜백에 대한 자세한 내용은 콜백을 참조하세요.