Fungsi GetDefaultCommConfigA (winbase.h)

Mengambil konfigurasi default untuk perangkat komunikasi yang ditentukan.

Sintaks

BOOL GetDefaultCommConfigA(
  [in]      LPCSTR       lpszName,
  [out]     LPCOMMCONFIG lpCC,
  [in, out] LPDWORD      lpdwSize
);

Parameter

[in] lpszName

Nama perangkat. Misalnya, COM1 hingga COM9 adalah port serial dan LPT1 hingga LPT9 adalah port paralel.

[out] lpCC

Penunjuk ke buffer yang menerima struktur COMMCONFIG .

[in, out] lpdwSize

Penunjuk ke variabel yang menentukan ukuran buffer yang diacu oleh lpCC, dalam byte. Setelah kembali, variabel berisi jumlah byte yang disalin jika fungsi berhasil, atau jumlah byte yang diperlukan jika buffer terlalu kecil.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, gunakan fungsi GetLastError .

Keterangan

Catatan

Header winbase.h mendefinisikan GetDefaultCommConfig sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP
Server minimum yang didukung	Windows Server 2003
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

COMMCONFIG

Fungsi Komunikasi

Sumber Daya Komunikasi

SetDefaultCommConfig