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 |
|---|---|
|
L'opération a réussi. |
|
Le paramètre portType n’est pas valide. |
|
Une erreur inattendue s’est produite. |
|
Le paramètre PortName a la valeur null. |
|
La mémoire disponible est insuffisante pour effectuer cette requête. |
|
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. |
|
Le paramètre PortName contient un caractère non valide (l’un des caractères * suivants : « ? <>/ | » :»). |
|
Le paramètre PortName spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis. |
|
La configuration de cet ordinateur virtuel n’est pas valide. |
|
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 |
|
| IID |
IID _ IVMSerialPort est défini en tant que 2ce4460d-1d3f-4458-BF8B-44084b816815 |