IVMSerialPort::Configure 메서드

[Windows 가상 PC는 Windows 8 현재 더 이상 사용할 수 없습니다. 대신 Hyper-V WMI 공급자(V2)를 사용합니다.]

직렬 포트를 구성합니다.

구문

HRESULT Configure(
  [in] VMSerialPortType portType,
  [in] BSTR             portName,
  [in] VARIANT_BOOL     vmConnectImmediately
);

portType [in]: 직렬 포트의 형식입니다. 값 목록은 VMSerialPortType을 참조하세요.
portName [in]: 직렬 포트의 이름입니다. 예를 들어 vmSerialPort_HostPort "COM1", vmSerialPort_TextFile "C:\SerialPort.txt", vmSerialPort_NamedPipe "\\servername\pipe\pipename"입니다.
vmConnectImmediately [in]: TRUE 이면 가상 머신이 시작될 때 호스트 직렬 포트를 즉시 열어야 하고 그렇지 않으면 FALSE 입니다. portType이 vmSerialPort_HostPort 않으면 무시됩니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드/값	Description
S_OK 0	작업이 완료되었습니다.
E_INVALIDARG 0x80000003	portType 매개 변수가 잘못되었습니다.
DISP_E_EXCEPTION 0x80020009	예기치 않은 오류가 발생했습니다.
E_POINTER 0x80004003	portName 매개 변수는 NULL입니다.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY) 0x8007000e	이 요청을 완료하는 데 사용할 수 있는 메모리가 부족합니다.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	portName 매개 변수로 지정된 경로가 너무 깁니다. 경로는 MAX_PATH (260) 문자 미만이어야 합니다.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	portName 매개 변수에 잘못된 문자("*? 중 하나)가 포함되어 있습니다.<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	portName 매개 변수는 빈 경로 또는 상대 경로를 지정합니다. 절대 경로가 필요합니다.
VM_E_VM_UNKNOWN 0xA0040207	이 가상 머신에 대한 구성이 잘못되었습니다.
VM_E_PREF_ILLEGAL_VALUE 0xA0040301	지정된 포트가 이미 사용 중입니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
클라이언트 지원 종료	Windows 7
제품	Windows Virtual PC
헤더	VPCCOMInterfaces.h
IID	IID_IVMSerialPort 2ce4460d-1d3f-4458-bf8b-44084b816815로 정의됩니다.