Proprietà IVMVirtualMachine::Name

Articolo
06/13/2023

[Windows Virtual PC non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]

Recupera e imposta il nome della configurazione della macchina virtuale.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT put_Name(
  [in]          BSTR virtualMachineName
);

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

Valore proprietà

Specifica il nome della configurazione della macchina virtuale. La lunghezza del nome non può essere superiore a 80 caratteri e la lunghezza totale del percorso completo che include il file di configurazione del nome macchina virtuale non può essere maggiore di MAX_PATH (260).

Codici di errore

Nome/valore	Significato
S_OK 0	L'operazione è stata completata.
E_POINTER 0x80004003	Il parametro è NULL.
E_INVALIDARG 0x80000003	Il parametro non è valido o è una stringa vuota.
VM_E_VM_UNKNOWN 0xA0040207	La configurazione è sconosciuta.
VM_E_PREF_VM_ACTIVE 0xA0040302	La macchina virtuale è in esecuzione o salvata.
VM_E_CONFIG_NO_NAME 0xA0040400	Il parametro virtualMachineName è vuoto.
VM_E_CONFIG_NAME_TOO_LONG 0xA00400401	Il parametro contiene troppi caratteri.
VM_E_CONFIG_NAME_INVALID_CHAR 0xA0040402	Il parametro contiene uno dei caratteri non validi seguenti "*?:<>/\|\".".
VM_E_CONFIG_DUPLICATE_NAME 0xA0040403	Il nome specificato esiste già come nome di un'altra macchina virtuale.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Commenti

I nomi delle macchine virtuali sono senza distinzione tra maiuscole e minuscole, ad esempio "MyVM" e "myvm" fanno riferimento alla stessa macchina virtuale. Questa è la proprietà predefinita per IVMVirtualMachine.

Se VPC.exe è in esecuzione e la macchina virtuale viene salvata, l'impostazione della proprietà Name non avrà esito positivo. Se VPC.exe non è in esecuzione e la macchina virtuale viene salvata, l'impostazione della proprietà Name avrà esito positivo quando viene avviata VPC.exe.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Fine del supporto client	Windows 7
Prodotto	Windows Virtual PC
Intestazione	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine è definito come f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Vedi anche

IVMVirtualMachine

Condividi tramite