Compartir a través de


Función OpenCommPort (winbase.h)

Intenta abrir un dispositivo de comunicación.

Sintaxis

HANDLE OpenCommPort(
  [in] ULONG uPortNumber,
  [in] DWORD dwDesiredAccess,
  [in] DWORD dwFlagsAndAttributes
);

Parámetros

[in] uPortNumber

Número de puerto basado en uno para que el dispositivo de comunicación se abra.

[in] dwDesiredAccess

Acceso solicitado al dispositivo.

Para obtener más información sobre el acceso solicitado, vea CreateFile y Creating and Opening Files.

[in] dwFlagsAndAttributes

Marcas y atributos solicitados para el dispositivo.

Nota  

Para esta función, solo se esperan valores de FILE_FLAG_OVERLAPPED o 0x0 para este parámetro.

 
Valor Significado
FILE_FLAG_OVERLAPPED
0x40000000
El archivo o dispositivo se abre o se crea para E/S asincrónica.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un HANDLE válido. Use CloseHandle para cerrar ese identificador.

Si se produce un error, la función devuelve INVALID_HANDLE_VALUE.

Comentarios

El parámetro uPortNumber acepta valores basados en uno. Un valor de 1 para uPortNumber hace que esta función intente abrir COM1.

Para admitir UWP, vincula con WindowsApp.lib.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1709 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server, versión 1709 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library OneCore.lib
Archivo DLL KernelBase.dll

Consulte también

CloseHandle

CreateFile

Crear y abrir archivos