IVMVirtualMachine::Name 속성

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

가상 머신 구성의 이름을 검색하고 설정합니다.

이 속성은 읽기/쓰기가 가능합니다.

구문

HRESULT put_Name(
  [in]          BSTR virtualMachineName
);

HRESULT get_Name(
  [out, retval] BSTR *virtualMachineName
);

가상 머신 구성의 이름을 지정합니다. 이름의 길이는 80자를 초과할 수 없으며 가상 머신 이름 구성 파일을 포함하는 정규화된 경로의 총 길이는 MAX_PATH (260자)를 초과할 수 없습니다.

이름/값	의미
S_OK 0	작업이 완료되었습니다.
E_POINTER 0x80004003	매개 변수가 NULL입니다.
E_INVALIDARG 0x80000003	매개 변수가 잘못되거나 빈 문자열입니다.
VM_E_VM_UNKNOWN 0xA0040207	구성을 알 수 없습니다.
VM_E_PREF_VM_ACTIVE 0xA0040302	가상 머신이 실행 중이거나 저장됩니다.
VM_E_CONFIG_NO_NAME 0xA0040400	virtualMachineName 매개 변수가 비어 있습니다.
VM_E_CONFIG_NAME_TOO_LONG 0xA00400401	매개 변수에 너무 많은 문자가 포함되어 있습니다.
VM_E_CONFIG_NAME_INVALID_CHAR 0xA0040402	매개 변수에 다음 잘못된 문자 "*?:<>/\|\""가 포함되어 있습니다.
VM_E_CONFIG_DUPLICATE_NAME 0xA0040403	지정된 이름이 이미 다른 가상 머신의 이름으로 존재합니다.
DISP_E_EXCEPTION 0x80020009	예기치 않은 오류가 발생했습니다.

가상 머신 이름은 대/소문자를 구분하지 않습니다. 예를 들어 "MyVM" 및 "myvm"은 동일한 가상 머신을 참조합니다. IVMVirtualMachine의 기본 속성입니다.

VPC.exe 실행 중이고 VM이 저장되면 Name 속성 설정이 성공하지 않습니다. VPC.exe 실행되고 있지 않고 VM이 저장되면 VPC.exe 다음에 시작될 때 Name 속성 설정이 성공합니다.

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