다음을 통해 공유

DebugCreate 함수(dbgeng.h)

  • 아티클

DebugCreate 함수는 새 클라이언트 개체를 만들고 해당 개체에 대한 인터페이스 포인터를 반환합니다.

구문

HRESULT DebugCreate(
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

매개 변수

[in] InterfaceId

원하는 디버거 엔진 클라이언트 인터페이스의 IID(인터페이스 식별자)를 지정합니다. 인터페이스에서 반환되는 인터페이스의 형식입니다. 인터페이스 식별자에 대한 자세한 내용은 클라이언트 개체 사용을 참조하세요.

[out] Interface

새 클라이언트에 대한 인터페이스 포인터를 받습니다. 이 인터페이스의 형식은 InterfaceId로 지정됩니다.

반환 값

이 메서드는 다른 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요.

반환 코드 Description
S_OK
 함수가 성공했습니다.
E_NOINTERFACE
클라이언트 개체는 지정된 인터페이스를 구현하지 않습니다.

설명

DebugCreate에 전달된 매개 변수는 IUnknown::QueryInterface에 전달된 매개 변수와 동일하며 동일한 방식으로 처리됩니다.

IUnknown::QueryInterface와 마찬가지로 반환된 인터페이스가 더 이상 필요하지 않으면 IUnknown::Release 메서드를 호출해야 합니다.

이 함수와 이를 통해 얻은 인터페이스를 사용하기 위해 CoInitialize, CoInitializeEx 또는 OleInitialize 를 호출할 필요가 없습니다.

CoCreateInstance, CoCreateInstanceEx 또는 CoGetClassObject를 호출하여 디버거 엔진 클라이언트 인터페이스를 가져올 수 없습니다. DebugCreate, DebugCreateEx, DebugConnect 또는 DebugConnectWide를 사용하여 이러한 인터페이스를 만들거나 다른 디버거 엔진 클라이언트 인터페이스에서 IUnknown::QueryInterface를 호출합니다.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 dbgeng.h(Dbgeng.h 포함)

추가 정보

클라이언트 개체