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 구조체의 주소입니다.

예약 [ in]

이 매개 변수는 나중에 사용하도록 예약되어 있으며 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 오류 코드를 반환합니다.

설명

이 메서드는 비동기적이며, iConnectionBrokerRequest::CheckStatus 메서드가 CB_STATUS_REQUEST_COMPLETED 가져올 때까지 pTargetInfo 및 pResult 매개 변수는 유효한 상태를 유지해야 합니다.

이 메서드를 사용하는 방법에 대한 자세한 내용은 원격 데스크톱 연결 브로커 클라이언트 API를 사용하는 방법을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 8
지원되는 최소 서버
 Windows Server 2012
헤더
Cbclient.h
라이브러리
Cbclient.lib
DLL
Cbclient.dll

추가 정보

IConnectionBrokerClient