IVMSerialPort :: configure, méthode

[Windows Virtual PC ne peut plus être utilisé à partir de Windows 8. Au lieu de cela, utilisez le fournisseur WMI Hyper-V (v2).]

Configure le port série.

Syntaxe

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

Paramètres

portType [ dans]

Type de port série. Pour obtenir la liste des valeurs, consultez VMSerialPortType.

PortName [ dans]

Nom du port série. Par exemple, « COM1 » pour vmSerialPort _ appelait hostport, « C : \SerialPort.txt » pour vmSerialPort _ TextFile, ou « \ \ ServerName \ pipe \ pipeName» pour vmSerialPort _ NamedPipe.

vmConnectImmediately [ dans]

True si le port série de l’hôte doit être ouvert immédiatement au démarrage de l’ordinateur virtuel et false dans le cas contraire. Ignoré si portType n’est pas vmSerialPort _ appelait hostport.

Valeur retournée

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 _ POINTEUR
0x80004003
Le paramètre PortName a la valeur null.
Valeur
HRESULT _ À partir de _ Win32 (erreur _ OUTOFMEMORY)
0x8007000E
La mémoire disponible est insuffisante pour effectuer cette requête.
Valeur
HRESULT _ À partir de _ Win32 _ ( _ dépassement de mémoire tampon d’erreur)
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 à la longueur maximale _ (260) caractères.
Valeur
HRESULT _ À partir de _ Win32 (erreur _ _ nom non valide)
0x8007007b
Le paramètre PortName contient un caractère non valide (l’un des caractères * suivants : «  ? <>/ | » :»).
Valeur
HRESULT _ FROM _ Win32 (erreur _ de _ nom de chemin incorrect)
0x800700a1
Le paramètre PortName spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis.
Ordinateur virtuel _ _Machine virtuelle _
0xA0040207
inconnue
La configuration de cet ordinateur virtuel n’est pas valide.
Ordinateur virtuel _ E _ pref _ _ valeur non conforme
0xA0040301
Le port spécifié est déjà utilisé.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
applications de [ bureau Windows 7 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 en tant que 2ce4460d-1d3f-4458-BF8B-44084b816815

Voir aussi

IVMSerialPort