Interface IVMVirtualMachine

[Windows Virtual PC n’est plus disponible depuis Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

Définit l’interface d’une machine virtuelle. IVMVirtualMachine peut informer les clients des événements à l’aide de l’interface sortante IVMVirtualMachineEvents . Les objets IVMVirtualMachine sont retournés par des méthodes IVMVirtualPC telles que CreateVirtualMachine, RegisterVirtualMachine et FindVirtualMachine. Vous pouvez également récupérer un objet IVMVirtualMachine à partir de l’objet IVMVirtualMachineCollection retourné par la propriété IVMVirtualPC::VirtualMachines .

Membres

L’interface IVMVirtualMachine hérite de l’interface IDispatch. IVMVirtualMachine a également les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

L’interface IVMVirtualMachine a ces méthodes.

Méthode	Description
AddDVDROMDrive	Ajoute un nouveau lecteur de CD ou DE DVD à la machine virtuelle.
AddHardDiskConnection	Ajoute une nouvelle connexion de disque dur à la machine virtuelle.
AddNetworkAdapter	Ajoute une interface réseau à la machine virtuelle.
AttachUSBDevice	Attache un périphérique USB à une machine virtuelle.
DetachUSBDevice	Libère un périphérique USB à partir d’une machine virtuelle.
DiscardSavedState	Ignore toutes les informations d’état enregistrées pour une machine virtuelle enregistrée.
DiscardUndoDisks	Ignore les disques d’annulation virtuels.
GetActivationValue	Récupère la valeur du paramètre d’activation spécifié pour cette machine virtuelle.
GetConfigurationValue	Récupère la valeur du paramètre de configuration spécifié pour cette machine virtuelle.
MergeUndoDisks	Fusionne les disques d’annulation virtuels.
Suspendre	Suspend la machine virtuelle.
RemoveActivationValue	Supprime la valeur du paramètre d’activation spécifié pour cette machine virtuelle.
RemoveConfigurationValue	Supprime la valeur du paramètre de configuration spécifié pour cette machine virtuelle.
RemoveDVDROMDrive	Supprime le lecteur de CD ou DE DVD spécifié de la machine virtuelle.
RemoveHardDiskConnection	Supprime la connexion au disque dur spécifiée de la machine virtuelle.
RemoveNetworkAdapter	Supprime une interface réseau de la machine virtuelle.
Réinitialiser	Réinitialise la machine virtuelle.
Reprendre	Reprend la machine virtuelle.
Enregistrer	Enregistre l’état de la machine virtuelle.
SetActivationValue	Définit la valeur du paramètre d’activation spécifié pour cette machine virtuelle.
SetConfigurationValue	Définit la valeur du paramètre de configuration spécifié pour cette machine virtuelle.
StartCommunicationChannel	Configure un canal de communication entre l’hôte et l’invité.
Démarrage	Démarre la machine virtuelle à partir de l’état non initialisé ou enregistré.
Startup2	Démarre la machine virtuelle à partir de l’état non initialisé ou enregistré, avec des options avancées.
Sortie	Met l’ordinateur virtuel hors tension.

Propriétés

L’interface IVMVirtualMachine a ces propriétés.

Propriété	Type d’accès	Description
Comptable	Lecture seule	Un comptable pour cette machine virtuelle.
AttachedDriveTypes	Lecture seule	Tableau indiquant le type de lecteur attaché à chaque emplacement de la machine virtuelle.
BaseBoardSerialNumber	Lecture/écriture	Numéro de série de la carte de base.
BIOSGUID	Lecture/écriture	GUID du BIOS.
BIOSSerialNumber	Lecture/écriture	Numéro de série du BIOS.
ChassisAssetTag	Lecture/écriture	Balise de ressource châssis.
ChassisSerialNumber	Lecture/écriture	Numéro de série du châssis.
ConfigID	Lecture seule	Identificateur unique de la machine virtuelle.
Affichage	Lecture seule	Affichage vidéo de la machine virtuelle.
DVDROMDrives	Lecture seule	Collection énumérable de lecteurs CD et DVD attachés à la machine virtuelle.
Fichier	Lecture seule	Chemin complet du fichier .vmc pour la configuration de la machine virtuelle.
FloppyDrives	Lecture seule	Collection énumérable de lecteurs de disquettes attachés à la machine virtuelle.
GuestOS	Lecture seule	Système d’exploitation invité pour cette machine virtuelle.
HardDiskConnections	Lecture seule	Collection énumérable de connexions de disque dur.
Has3DNow	Lecture seule	Indique si le processeur prend en charge le jeu d’instructions 3DNow.
HasMMX	Lecture seule	Indique si le processeur prend en charge le jeu d’instructions MMX.
HasSSE	Lecture seule	Indique si le processeur prend en charge le jeu d’instructions SSE.
HasSSE2	Lecture seule	Indique si le processeur prend en charge le jeu d’instructions SSE2.
Clavier	Lecture seule	Périphérique clavier de la machine virtuelle.
Mémoire	Lecture/écriture	Quantité de mémoire physique dans la machine virtuelle, en mégaoctets.
Souris	Lecture seule	Périphérique de souris pour la machine virtuelle.
Nom	Lecture/écriture	Nom de la configuration de la machine virtuelle.
NetworkAdapters	Lecture seule	Collection énumérable de cartes réseau attachées à la machine virtuelle.
Notes	Lecture/écriture	Notes relatives à la machine virtuelle.
ParallelPorts	Lecture seule	Collection énumérable de ports parallèles.
ProcessorSpeed	Lecture seule	Vitesse du processeur, en mégahertz (MHz).
RdpPipeName	Lecture seule	Nom du canal nommé de connexion RDP utilisé pour la vidéo et l’entrée.
SavedStateFilePath	Lecture seule	Chemin d’accès complet au fichier d’état enregistré.
SerialPorts	Lecture seule	Collection énumérable de ports série.
ShutdownActionOnQuit	Lecture/écriture	Action à effectuer sur cette machine virtuelle si elle est en cours d’exécution lorsque le PC virtuel Windows est arrêté.
State	Lecture seule	État actuel de la machine virtuelle.
Annulable	Lecture/écriture	Indique si les lecteurs d’annulation sont activés pour les disques durs connectés à la machine virtuelle.
UndoAction	Lecture/écriture	Action par défaut à effectuer sur tous les lecteurs d’annulation lorsque la machine virtuelle est arrêtée à partir du système d’exploitation invité.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Fin de la prise en charge des clients	Windows 7
Produit	Windows Virtual PC
En-tête	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine est défini comme f7092aa1-33ed-4f78-a59f-c00adfc2edd7