IVMVirtualMachine::AddHardDiskConnection 메서드

  • 아티클

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

VM(가상 머신)에 새 하드 디스크 연결을 추가합니다.

구문

HRESULT AddHardDiskConnection(
  [in]          BSTR                  hardDiskPath,
  [in]          long                  busNumber,
  [in]          long                  deviceNumber,
  [out, retval] IVMHardDiskConnection **hardDiskConnection
);

매개 변수

hardDiskPath [in]

연결할 VHD(가상 하드 디스크) 파일의 전체 경로입니다.

busNumber [in]

드라이브를 연결할 버스입니다.

값 의미
0
 드라이브가 첫 번째 버스에 연결됩니다.
1
 드라이브는 두 번째 버스에 연결됩니다.

deviceNumber [in]

드라이브를 연결할 디바이스입니다.

값 의미
0
 드라이브는 버스의 첫 번째 장치에 연결됩니다.
1
 드라이브는 버스의 두 번째 장치에 연결됩니다.

hardDiskConnection [out, retval]

IVMHardDiskConnection 개체입니다.

반환 값

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

반환 코드/값 Description
S_OK
0
 작업이 완료되었습니다.
E_POINTER
0x80004003
 hardDiskConnection 매개 변수는 NULL입니다.
E_INVALIDARG
0x80000003
 hardDiskPath 매개 변수가 NULL이거나 busNumber 또는 deviceNumber 매개 변수가 잘못되었습니다.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 시스템에서 hardDiskPath 매개 변수로 지정된 파일을 찾을 수 없습니다.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 시스템에서 hardDiskPath 매개 변수로 지정된 경로를 찾을 수 없습니다.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 hardDiskPath 매개 변수에 잘못된 문자가 포함되어 있습니다("*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 hardDiskPath 매개 변수는 빈 경로 또는 상대 경로를 지정합니다. 절대 경로가 필요합니다.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 hardDiskPath 매개 변수로 지정된 경로가 너무 깁니다. 경로는 260자 미만이어야 합니다.
VM_E_VM_UNKNOWN
0xA0040207
 구성을 알 수 없습니다.
VM_E_VM_RUNNING_OR_SAVED
0xA004020B
 VM이 실행 중이거나 저장된 상태입니다.
VM_E_DRIVE_BUS_LOC_IN_USE
0xA00400503
 지정된 버스 위치가 사용 중입니다.
VM_E_INVALID_HD_FILE
0xA0040682
 VHD가 127GB보다 크며 IDE 버스에 연결할 수 없습니다.
VM_E_UNSUPPORTED_HD_DISK_TYPE
0xA00400686
 hardDiskPath 매개 변수는 연결된 VHD 또는 연결된 VHD에 대한 차이점 VHD를 나타냅니다. 연결된 VHD는 가상 머신에 연결할 수 없습니다.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 지정된 VHD가 이 VM의 다른 버스 위치에 이미 연결되어 있습니다.
DISP_E_EXCEPTION
0x80020009
 예기치 않은 오류가 발생했습니다.

설명

중지된 가상 머신에만 새 하드 디스크 연결을 추가할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버
 지원되는 버전 없음
클라이언트 지원 종료
 Windows 7
제품
 Windows Virtual PC
헤더
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine f7092aa1-33ed-4f78-a59f-c00adfc2edd7로 정의됩니다.

추가 정보

IVMVirtualMachine