Share via

Функция 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.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.

Комментарии

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

Клиентские объекты

Сервер обработки и интеллектуальный клиент