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 構造体のアドレス。

予約済み [入力]

このパラメーターは将来使用するために予約されており、0 である必要があります。

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