Fungsi GetDefaultCommConfigW (winbase.h)

Mengambil konfigurasi default untuk perangkat komunikasi yang ditentukan.

Sintaksis

BOOL GetDefaultCommConfigW(
  [in]      LPCWSTR      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

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

Mengembalikan nilai

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 .

Komentar

Nota

Header winbase.h mendefinisikan GetDefaultCommConfig sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

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

Lihat juga

COMMCONFIG

Communications Functions

Sumber Daya Komunikasi

SetDefaultCommConfig