GetDefaultCommConfigW 函式 (winbase.h)

擷取指定通訊裝置的預設組態。

語法

BOOL GetDefaultCommConfigW(
  [in]      LPCWSTR      lpszName,
  [out]     LPCOMMCONFIG lpCC,
  [in, out] LPDWORD      lpdwSize
);

[in] lpszName

裝置的名稱。例如，COM1 到 COM9 是序列埠，而 LPT1 到 LPT9 是平行埠。

[out] lpCC

接收 COMMCONFIG 結構的緩衝區指標。

[in, out] lpdwSize

變數的指標，指定 lpCC 所指向的緩衝區大小，以位元組為單位。傳回時，變數會包含函式成功時所複製的位元元組數目，或緩衝區太小時所需的位元組數目。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請使用 GetLastError 函式。

注意

winbase.h 標頭會將 GetDefaultCommConfig 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。