IVMVirtualMachine::StartCommunicationChannel, méthode

Article
06/13/2023

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

Configure un canal de communication entre le système d’exploitation hôte et le système d’exploitation invité.

Syntaxe

HRESULT StartCommunicationChannel(
  [in] VMEndpointType inHostEndpointType,
  [in] BSTR           inHostEndPointName,
  [in] VMEndpointType inGuestEndpointType,
  [in] BSTR           inGuestEndpointName
);

Paramètres

inHostEndpointType [in]: Ce paramètre doit être vmEndpoint_NamedPipe (0).
inHostEndPointName [in]: Nom unique du canal. Cette chaîne doit avoir la forme suivante : « \\.\pipe\pipename ». La partie pipename du nom peut inclure n’importe quel caractère autre qu’une barre oblique inverse, y compris des nombres et des caractères spéciaux. La chaîne entière du nom de canal peut avoir jusqu’à 256 caractères. Les noms de canal ne respectent pas la casse.
inGuestEndpointType [in]: Ce paramètre doit être vmEndpoint_TCPIP (1).
inGuestEndpointName [in]: Numéro de port sur lequel le serveur TCP dans l’invité écoute.

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 inHostEndpointType n’est pas vmEndpoint_NamedPipe (0) ou le paramètre inGuestEndpointType n’est pas vmEndpoint_TCPIP (1).
E_POINTER 0x80004003	Le paramètre inHostEndPointName ou inGuestEndpointName a la valeur NULL ou n’est pas une valeur valide.
DISP_E_EXCEPTION 0x80020009	Une erreur inattendue s’est produite.
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE) 0x80070006	Un handle n’est pas valide.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY) 0x8007000e	La mémoire disponible est insuffisante pour effectuer cette demande.
HRESULT_FROM_WIN32(ERROR_NOT_READY) 0x80070015	Le système sous-jacent qu’il utilise pour fournir des services réseau est en cours d’initialisation.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Le nom du canal est déjà utilisé.
HRESULT_FROM_WIN32(ERROR_PIPE_BUSY) 0x800700e7	Un ou plusieurs canaux sont en panne et peuvent être disponibles sous peu.
HRESULT_FROM_WIN32(ERROR_MAX_SESSIONS_REACHED) 0x80070161	Le nombre maximal de canaux de communication disponibles est en cours d’utilisation. Un autre canal ne peut pas être démarré pour l’instant.
HRESULT_FROM_WIN32(ERROR_REVISION_MISMATCH) 0x8007051a	Il existe une incompatibilité entre la version du sous-système hôte et les sous-systèmes invités. Pour plus d’informations, consultez le Journal des événements Windows.
VM_E_VM_NOT_RUNNING 0xA0040206	La machine virtuelle n’est pas en cours d’exécution.

Notes

L’implémentation actuelle prend uniquement en charge l’interface de canal nommé sur l’hôte et l’interface TCP/IP sur le 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

Voir aussi

IVMVirtualMachine
VMEndpointType

Partager via