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 |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|