共用方式為

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
 沒有可用的命令埠。

規格需求

   
最低支援的用戶端 Windows 10版本 1803 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 版本 1709 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 OneCore.lib
Dll KernelBase.dll