Compartir a través de

IVMSerialPort::Configure (método)

  • Artículo

[Windows Virtual PC ya no está disponible para su uso a partir de Windows 8. En su lugar, use el proveedor WMI de Hyper-V (V2)].

Configura el puerto serie.

Sintaxis

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

Parámetros

portType [in]

Tipo de puerto serie. Para obtener una lista de valores, consulte VMSerialPortType.

portName [in]

Nombre del puerto serie. Por ejemplo, "COM1" para vmSerialPort_HostPort, "C:\SerialPort.txt" para vmSerialPort_TextFile, o "\\servername\pipe\pipename" para vmSerialPort_NamedPipe.

vmConnectImmediately [in]

TRUE si el puerto serie del host debe abrirse inmediatamente cuando se inicia la máquina virtual y FALSE de lo contrario. Se omite si portType no está vmSerialPort_HostPort.

Valor devuelto

Este método puede devolver uno de estos valores.

Código o valor devuelto Descripción
S_OK
0
 La operación se realizó correctamente.
E_INVALIDARG
0x80000003
 El parámetro portType no es válido.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.
E_POINTER
0x80004003
 El parámetro portName es NULL.
HRESULT_FROM_WIN32(ERROR_OUTOFMEMORY)
0x8007000e
 No hay suficiente memoria disponible para completar esta solicitud.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 La ruta de acceso especificada por el parámetro portName es demasiado larga. La ruta de acceso debe tener menos de MAX_PATH (260) caracteres.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 El parámetro portName contiene un carácter no válido (uno de "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 El parámetro portName especifica una ruta de acceso vacía o relativa. Se requiere una ruta de acceso absoluta.
VM_E_VM_UNKNOWN
0xA0040207
 La configuración de esta máquina virtual no es válida.
VM_E_PREF_ILLEGAL_VALUE
0xA0040301
 El puerto especificado ya está en uso.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible
 No se admite ninguno
Fin de compatibilidad de cliente
 Windows 7
Producto
 Windows Virtual PC
Encabezado
VPCCOMInterfaces.h
IID
 IID_IVMSerialPort se define como 2ce4460d-1d3f-4458-bf8b-44084b816815

Vea también

IVMSerialPort