Compartilhar via

Função GetCommPorts (winbase.h)

  • Artigo

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