IVMSerialPort::Configure, méthode

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

Configure le port série.

Syntaxe

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

portType [in]: Type de port série. Pour obtenir la liste des valeurs, consultez VMSerialPortType.
portName [in]: Nom du port série. Par exemple, « COM1 » pour vmSerialPort_HostPort, « C:\SerialPort.txt » pour vmSerialPort_TextFile ou « \\servername\pipe\pipename » pour vmSerialPort_NamedPipe.
vmConnectImmediately [in]: TRUE si le port série de l’hôte doit être ouvert immédiatement au démarrage de la machine virtuelle et FALSE dans le cas contraire. Ignoré si portType n’est pas vmSerialPort_HostPort.

Cette méthode peut retourner l’une de ces valeurs.

Code/valeur de retour	Description
S_OK 0	L'opération a réussi.
E_INVALIDARG 0x80000003	Le paramètre portType n’est pas valide.
DISP_E_EXCEPTION 0x80020009	Une erreur inattendue s’est produite.
E_POINTER 0x80004003	Le paramètre portName est NULL.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY) 0x8007000e	La mémoire disponible est insuffisante pour effectuer cette demande.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Le chemin d’accès spécifié par le paramètre portName est trop long. Le chemin d’accès doit être inférieur à MAX_PATH (260) caractères.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Le paramètre portName contient un caractère non valide (l’un des « * ? »<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Le paramètre portName spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis.
VM_E_VM_UNKNOWN 0xA0040207	La configuration de cette machine virtuelle n’est pas valide.
VM_E_PREF_ILLEGAL_VALUE 0xA0040301	Le port spécifié est déjà utilisé.

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_IVMSerialPort est défini comme 2ce4460d-1d3f-4458-bf8b-44084b816815