DebugConnect 함수(dbgeng.h)

DebugConnect 및 DebugConnectWide 함수는 새 클라이언트 개체를 만들고 인터페이스 포인터를 반환합니다. 클라이언트 개체가 원격 호스트에 연결됩니다.

구문

HRESULT DebugConnect(
  [in]  PCSTR  RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

[in] RemoteOptions

디버거 엔진이 원격 호스트에 연결하는 방법을 지정합니다. 명령줄의 -remote 옵션에 전달되는 것과 동일한 옵션입니다. 이 문자열의 구문에 대한 자세한 내용은 디버깅 클라이언트 활성화를 참조하세요.

[in] InterfaceId

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

[out] Interface

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

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

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

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

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

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

프로세스 서버 및 스마트 클라이언트