Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 |
|---|---|
|
A chamada foi bem-sucedida. A matriz lpPortNumbers era grande o suficiente para o resultado. |
|
A matriz lpPortNumbers era muito pequena para conter todos os números de porta disponíveis. |
|
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 |