Bagikan melalui

Fungsi GetCommPorts (winbase.h)

  • Artikel

Mendapatkan array yang berisi port COM yang terbentuk dengan baik.

Fungsi ini mendapatkan nomor port COM dari kunci registri HKLM\Hardware\DeviceMap\SERIALCOMM dan kemudian menulisnya ke array yang disediakan pemanggil. Jika array terlalu kecil, fungsi akan mendapatkan ukuran yang diperlukan.

Catatan Jika entri baru ditambahkan ke kunci registri, ukuran yang diperlukan dapat berubah di antara panggilan API.
 

Sintaks

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

Parameter

[out] lpPortNumbers

Array untuk nomor port.

[in] uPortNumbersCount

Panjang array dalam parameter lpPortNumbers .

[out] puPortNumbersFound

Jumlah nomor port yang ditulis ke lpPortNumbers atau panjang array yang diperlukan untuk nomor port.

Menampilkan nilai

Menampilkan kode Deskripsi
ERROR_SUCCESS
 Panggilan berhasil. Array lpPortNumbers cukup besar untuk hasilnya.
ERROR_MORE_DATA
 Array lpPortNumbers terlalu kecil untuk memuat semua nomor port yang tersedia.
ERROR_FILE_NOT_FOUND
 Tidak ada port comm yang tersedia.

Persyaratan

   
Klien minimum yang didukung Windows 10, versi 1803 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server, versi 1709 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header winbase.h (termasuk Windows.h)
Pustaka OneCore.lib
DLL KernelBase.dll