Функция GetCommPorts (winbase.h)

Статья
08/27/2023

Возвращает массив, содержащий правильно сформированные COM-порты.

Эта функция получает номера com-портов из раздела реестра HKLM\Hardware\DeviceMap\SERIALCOMM , а затем записывает их в предоставленный вызывающим массивом. Если массив слишком мал, функция получает необходимый размер.

Примечание Если в раздел реестра добавляются новые записи, между вызовами API может измениться необходимый размер.

Синтаксис

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

Параметры

[out] lpPortNumbers

Массив для номеров портов.

[in] uPortNumbersCount

Длина массива в параметре lpPortNumbers .

[out] puPortNumbersFound

Количество номеров портов, записанных в lpPortNumbers , или длина массива, необходимого для номеров портов.

Возвращаемое значение

Код возврата	Описание
ERROR_SUCCESS	Вызов выполнен успешно. Массив lpPortNumbers был достаточно большим для результата.
ERROR_MORE_DATA	Массив lpPortNumbers был слишком мал, чтобы содержать все доступные номера портов.
ERROR_FILE_NOT_FOUND	Нет доступных портов comm.

Требования


Минимальная версия клиента	Windows 10 версии 1803 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server версии 1709 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	OneCore.lib
DLL	KernelBase.dll

Поделиться через