Функция DebugConnect (dbgeng.h)

Статья
02/06/2025

Функции DebugConnect и DebugConnectWide создают новый клиентский объект и возвращают указатель интерфейса. Клиентский объект будет подключен к удаленному узлу.

Синтаксис

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

Параметры

[in] RemoteOptions

Указывает, как подсистема отладчика будет подключаться к удаленному узлу. Это те же параметры, которые передаются в параметр -remote в командной строке. Дополнительные сведения о синтаксисе этой строки см. в активацииклиента отладки.

[in] InterfaceId

Указывает идентификатор интерфейса (IID) требуемого клиентского интерфейса подсистемы отладчика. Это тип интерфейса, который будет возвращен в интерфейсе . Сведения об идентификаторе интерфейса см. в разделе Использование клиентских объектов.

[out] Interface

Получает указатель интерфейса для нового клиента. Тип этого интерфейса указывается InterfaceId.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код	Описание
S_OK	Метод был успешным.

Замечания

Как и IUnknown::QueryInterface, когда возвращенный интерфейс больше не нужен, его метод IUnknown::Release должен вызываться.

Вам не нужно вызывать CoInitialize, CoInitializeExили OleInitialize, чтобы использовать эту функцию и интерфейсы, полученные им.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	dbgeng.h (include Dbgeng.h)

См. также

клиентских объектов

Сервер обработки и смарт-клиент

Поделиться через