Função GetCommPorts (winbase.h)

Artigo
08/27/2023

Obtém uma matriz que contém as portas COM bem formadas.

Essa função obtém os números da porta COM da chave do registro HKLM\Hardware\DeviceMap\SERIALCOMM e grava-os em uma matriz fornecida pelo chamador. Se a matriz for muito pequena, a função obterá o tamanho necessário.

Nota Se novas entradas forem adicionadas à chave do Registro, o tamanho necessário poderá ser alterado entre chamadas à API.

Sintaxe

ULONG GetCommPorts(
  [out] PULONG lpPortNumbers,
  [in]  ULONG  uPortNumbersCount,
  [out] PULONG puPortNumbersFound
);

Parâmetros

[out] lpPortNumbers

Uma matriz para os números da porta.

[in] uPortNumbersCount

O comprimento da matriz no parâmetro lpPortNumbers .

[out] puPortNumbersFound

O número de números de porta gravados em lpPortNumbers ou o comprimento da matriz necessária para os números da porta.

Valor retornado

Código de retorno	Descrição
ERROR_SUCCESS	A chamada foi bem-sucedida. A matriz lpPortNumbers era grande o suficiente para o resultado.
ERROR_MORE_DATA	A matriz lpPortNumbers era muito pequena para conter todos os números de porta disponíveis.
ERROR_FILE_NOT_FOUND	Não há portas de comm disponíveis.

Requisitos


Cliente mínimo com suporte	Windows 10, versão 1803 [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

Compartilhar via