SetDefaultCommConfigA 函式（winbase.h）

設定通訊裝置的預設組態。

語法

BOOL SetDefaultCommConfigA(
  [in] LPCSTR       lpszName,
  [in] LPCOMMCONFIG lpCC,
  [in] DWORD        dwSize
);

[in] lpszName

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

[in] lpCC

COMMCONFIG 結構的指標。

[in] dwSize

lpCC 所指向的結構大小，以位元組為單位。

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

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

注意

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