IVMVirtualMachine::StartCommunicationChannel 메서드
[Windows 가상 PC는 Windows 8 현재 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]
호스트와 게스트 운영 체제 간의 통신 채널을 설정합니다.
구문
HRESULT StartCommunicationChannel(
[in] VMEndpointType inHostEndpointType,
[in] BSTR inHostEndPointName,
[in] VMEndpointType inGuestEndpointType,
[in] BSTR inGuestEndpointName
);
매개 변수
-
inHostEndpointType [in]
-
이 매개 변수는 vmEndpoint_NamedPipe (0)이어야 합니다.
-
inHostEndPointName [in]
-
고유한 파이프 이름입니다. 이 문자열의 형식은 "\\.\pipe\pipename"이어야 합니다. 이름의 pipename 부분에는 숫자 및 특수 문자를 포함하여 백슬래시 이외의 문자가 포함될 수 있습니다. 전체 파이프 이름 문자열의 길이는 최대 256자입니다. 파이프 이름은 대/소문자를 구분하지 않습니다.
-
inGuestEndpointType [in]
-
이 매개 변수는 vmEndpoint_TCPIP (1)이어야 합니다.
-
inGuestEndpointName [in]
-
게스트의 TCP 서버가 수신 대기하는 포트 번호입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드/값 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
inHostEndpointType 매개 변수가 vmEndpoint_NamedPipe(0)가 아니거나 inGuestEndpointType 매개 변수가 vmEndpoint_TCPIP(1)이 아닙니다. |
|
inHostEndPointName 또는 inGuestEndpointName 매개 변수는 NULL이거나 유효한 값이 아닙니다. |
|
예기치 않은 오류가 발생했습니다. |
|
핸들이 잘못되었습니다. |
|
이 요청을 완료하는 데 사용할 수 있는 메모리가 부족합니다. |
|
네트워크 서비스를 제공하는 데 사용하는 기본 시스템이 현재 초기화되고 있습니다. |
|
파이프 이름이 이미 사용 중입니다. |
|
하나 이상의 채널이 실행 중이며 곧 사용할 수 있게 될 수 있습니다. |
|
사용 가능한 최대 통신 채널 수는 사용 중입니다. 다른 채널은 현재 시작할 수 없습니다. |
|
호스트 버전과 게스트 하위 시스템 간에 불일치가 있습니다. 자세한 내용은 Windows 이벤트 로그를 참조하세요. |
|
VM이 실행되고 있지 않습니다. |
설명
현재 구현은 호스트의 명명된 파이프 인터페이스와 게스트 운영 체제의 TCP/IP 인터페이스만 지원합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 클라이언트 지원 종료 |
Windows 7 |
| 제품 |
Windows Virtual PC |
| 헤더 |
|
| IID |
IID_IVMVirtualMachine f7092aa1-33ed-4f78-a59f-c00adfc2edd7로 정의됩니다. |