Compartir a través de

Función GetCommPorts (winbase.h)

  • Artículo

Obtiene una matriz que contiene los puertos COM bien formados.

Esta función obtiene los números de puerto COM de la clave del Registro HKLM\Hardware\DeviceMap\SERIALCOMM y, a continuación, los escribe en una matriz proporcionada por el autor de la llamada. Si la matriz es demasiado pequeña, la función obtiene el tamaño necesario.

Nota Si se agregan nuevas entradas a la clave del Registro, el tamaño necesario puede cambiar entre llamadas API.
 

Sintaxis

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

Parámetros

[out] lpPortNumbers

Matriz para los números de puerto.

[in] uPortNumbersCount

Longitud de la matriz en el parámetro lpPortNumbers .

[out] puPortNumbersFound

Número de números de puerto escritos en lpPortNumbers o la longitud de la matriz necesaria para los números de puerto.

Valor devuelto

Código devuelto Descripción
ERROR_SUCCESS
 La llamada se realizó correctamente. La matriz lpPortNumbers era lo suficientemente grande como para el resultado.
ERROR_MORE_DATA
 La matriz lpPortNumbers era demasiado pequeña para contener todos los números de puerto disponibles.
ERROR_FILE_NOT_FOUND
 No hay ningún puerto comm disponible.

Requisitos

   
Cliente mínimo compatible Windows 10, versión 1803 [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