Compartilhar via

Método IVMSerialPort::Configure

  • Artigo

[O Computador Virtual do Windows 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 a porta serial.

Sintaxe

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

Parâmetros

portType [in]

O tipo de porta serial. Para obter uma lista de valores, consulte VMSerialPortType.

portName [in]

O nome da porta serial. Por exemplo, "COM1" para vmSerialPort_HostPort, "C:\SerialPort.txt" para vmSerialPort_TextFile ou "\\servername\pipe\pipename" para vmSerialPort_NamedPipe.

vmConnectImmediately [in]

TRUE se a porta serial do host deve ser aberta imediatamente quando a máquina virtual for iniciada e FALSE caso contrário. Ignorado se portType não for vmSerialPort_HostPort.

Valor retornado

Esse método pode retornar um desses valores.

Retornar código/valor Descrição
S_OK
0
 A operação foi bem-sucedida.
E_INVALIDARG
0x80000003
 O parâmetro portType não é válido.
DISP_E_EXCEPTION
0x80020009
 Ocorreu um erro inesperado.
E_POINTER
0x80004003
 O parâmetro portName é NULL.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY)
0x8007000e
 Não há memória suficiente disponível para concluir essa solicitação.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 O caminho especificado pelo parâmetro portName é muito longo. O caminho deve ter menos de MAX_PATH (260) caracteres.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 O parâmetro portName contém um caractere inválido (um de "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 O parâmetro portName especifica um caminho vazio ou relativo. Um caminho absoluto é necessário.
VM_E_VM_UNKNOWN
0xA0040207
 A configuração dessa máquina virtual não é válida.
VM_E_PREF_ILLEGAL_VALUE
0xA0040301
 A porta especificada já está em uso.

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_IVMSerialPort é definido como 2ce4460d-1d3f-4458-bf8b-44084b816815

Confira também

IVMSerialPort