Função OpenCommPort (winbase.h)

Tenta abrir um dispositivo de comunicação.

Sintaxe

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

[in] uPortNumber

Um número de porta baseado em um para o dispositivo de comunicação abrir.

[in] dwDesiredAccess

O acesso solicitado ao dispositivo.

Para obter mais informações sobre o acesso solicitado, consulte CreateFile e Criando e abrindo arquivos.

[in] dwFlagsAndAttributes

Os sinalizadores e atributos solicitados para o dispositivo.

Observação

Para essa função, apenas valores de FILE_FLAG_OVERLAPPED ou 0x0 são esperados para esse parâmetro.

Valor	Significado
FILE_FLAG_OVERLAPPED 0x40000000	O arquivo ou dispositivo está sendo aberto ou criado para E/S assíncrona.

Se a função for bem-sucedida, a função retornará um HANDLE válido. Use CloseHandle para fechar esse identificador.

Se ocorrer um erro, a função retornará INVALID_HANDLE_VALUE.

O parâmetro uPortNumber aceita valores baseados em um. Um valor de 1 para uPortNumber faz com que essa função tente abrir COM1.

Para dar suporte à UWP, vincule-se ao WindowsApp.lib.

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1709 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server, versão 1709 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (inclua Windows.h)
Biblioteca	OneCore.lib
DLL	KernelBase.dll