Share via

Método IVMVirtualMachine::StartCommunicationChannel

  • Artigo

[Windows Computador Virtual não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]

Configura um canal de comunicação entre o host e o sistema operacional convidado.

Sintaxe

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

Parâmetros

inHostEndpointType [in]

Esse parâmetro deve ser vmEndpoint_NamedPipe (0).

inHostEndPointName [in]

O nome exclusivo do pipe. Essa cadeia de caracteres deve ter o seguinte formulário: "\\.\pipe\pipename". A parte do nome do pipe pode incluir qualquer caractere diferente de uma barra invertida, incluindo números e caracteres especiais. Toda a cadeia de caracteres de nome do pipe pode ter até 256 caracteres. Os nomes de pipe não diferenciam maiúsculas de minúsculas.

inGuestEndpointType [in]

Esse parâmetro deve ser vmEndpoint_TCPIP (1).

inGuestEndpointName [in]

O número da porta no qual o servidor TCP no convidado está escutando.

Valor retornado

Esse método pode retornar um desses valores.

Código/valor de retorno Descrição
S_OK
0
 A operação foi bem-sucedida.
E_INVALIDARG
0x80000003
 O parâmetro inHostEndpointType não é vmEndpoint_NamedPipe (0) ou o parâmetro inGuestEndpointType não é vmEndpoint_TCPIP (1).
E_POINTER
0x80004003
 O parâmetro inHostEndPointName ou inGuestEndpointName é NULL ou não é um valor válido.
DISP_E_EXCEPTION
0x80020009
 Ocorreu um erro inesperado.
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
0x80070006
 Um identificador não é válido.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY)
0x8007000e
 Não há memória suficiente disponível para concluir essa solicitação.
HRESULT_FROM_WIN32(ERROR_NOT_READY)
0x80070015
 O sistema subjacente que ele usa para fornecer serviços de rede está sendo inicializado no momento.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 O nome do pipe já está em uso.
HRESULT_FROM_WIN32(ERROR_PIPE_BUSY)
0x800700e7
 Um ou mais canais estão em execução e podem ficar disponíveis em breve.
HRESULT_FROM_WIN32(ERROR_MAX_SESSIONS_REACHED)
0x80070161
 Os números máximos de canais de comunicação disponíveis estão em uso. Outro canal não pode ser iniciado no momento.
HRESULT_FROM_WIN32(ERROR_REVISION_MISMATCH)
0x8007051a
 Há uma incompatibilidade entre a versão dos subsistemas de host e convidado. Consulte o log de eventos do Windows para obter mais detalhes.
VM_E_VM_NOT_RUNNING
0xA0040206
 A VM não está em execução.

Comentários

A implementação atual dá suporte apenas à interface de pipe nomeada no host e na interface TCP/IP no sistema operacional convidado.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Nenhum compatível
Fim do suporte ao cliente
 Windows 7
Produto
 Windows Virtual PC
Cabeçalho
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine é definido como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Confira também

IVMVirtualMachine

VMEndpointType