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

Метод IConnectionBrokerClient::GetTargetInfo

  • Статья

Запрашивает сведения о целевом компьютере, на котором должно быть перенаправлено подключение. Этот метод используется перенаправлением для получения сведений о перенаправлении для входящего запроса на подключение.

Синтаксис

HRESULT GetTargetInfo(
  [in]  CB_CONNECTION_INFO       *pConnectionInfo,
  [in]  DWORD                    Reserved,
  [in]  HANDLE                   hStatusEvent,
  [out] CB_TARGET_INFO           *pTargetInfo,
  [out] DWORD                    *pResult,
  [out] IConnectionBrokerRequest **ppCbReq
);

Параметры

pConnectionInfo [in]

Адрес структуры CB_CONNECTION_INFO , содержащей сведения о входящем запросе на подключение.

Зарезервировано [в]

Этот параметр зарезервирован для использования в будущем и должен иметь нулевое значение.

hStatusEvent [in]

Дескриптор события, который будет задаваться при каждом обновлении хода выполнения запроса. Вы отвечаете за создание и закрытие этого события.

pTargetInfo [out]

Адрес структуры CB_TARGET_INFO , получающей сведения о целевом компьютере, на котором должно быть перенаправлено входящее подключение. Так как это асинхронный метод, эта память должна оставаться доступной до завершения запроса. Дополнительные сведения см. в подразделе "Примечания".

pResult [out]

Адрес переменной DWORD , которая получает код результата. Так как это асинхронный метод, эта память должна оставаться доступной до завершения запроса. Дополнительные сведения см. в подразделе "Примечания".

Этот код результата будет иметь одно из следующих значений.

0

Успешно.

0x0000400

Не удалось найти конечный компьютер.

0x0000401

Конечный компьютер недоступен.

0x0000402

Ошибка при загрузке конечного компьютера.

0x0000403

Ошибка при приведении конечного компьютера к сети.

0x0000404

Ошибка при перенаправлении на конечный компьютер.

0x0000405

Ошибка пробуждения виртуальной машины.

0x0000406

Ошибка при загрузке виртуальной машины.

0x0000407

Ошибка при поиске IP-адреса виртуальной машины.

0x0000408

Брокер сеансов не может найти доступные компьютеры в пуле.

0x0000409

Брокер сеансов отменил подключение.

0x0000410

Брокер сеансов не может проверить параметры подключения.

ppCbReq [out]

Адрес указателя интерфейса IConnectionBrokerRequest , который используется для получения обновлений состояния для асинхронной операции. Этот интерфейс используется вместе с параметром hStatusEvent для ожидания и получения результатов этой асинхронной операции.

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

Возвращает E_PENDING , если создан асинхронный запрос. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод является асинхронным. Параметры pTargetInfo и pResult должны оставаться действительными до тех пор, пока метод IConnectionBrokerRequest::CheckStatusне получит CB_STATUS_REQUEST_COMPLETED.

Дополнительные сведения об использовании этого метода см. в статье Использование КЛИЕНТСКОго API брокера подключений к удаленному рабочему столу.

Требования

Требование Значение
Минимальная версия клиента
 Windows 8
Минимальная версия сервера
 Windows Server 2012
Заголовок
Cbclient.h
Библиотека
Cbclient.lib
DLL
Cbclient.dll

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

IConnectionBrokerClient