getCommPorts 函数 (winbase.h)

获取包含格式正确的 COM 端口的数组。

此函数从 HKLM\Hardware\DeviceMap\SERIALCOMM 注册表项获取 COM 端口号，然后将其写入调用方提供的数组。如果数组太小，该函数将获取所需的大小。

注意如果向注册表项添加新条目，则 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 端口。