CommConfigDialogA 函式（winbase.h）

顯示驅動程式提供的組態對話框。

語法

BOOL CommConfigDialogA(
  [in]      LPCSTR       lpszName,
  [in]      HWND         hWnd,
  [in, out] LPCOMMCONFIG lpCC
);

[in] lpszName

應顯示對話框的裝置名稱。例如，COM1 到 COM9 是序列埠，而 LPT1 到 LPT9 是平行埠。

[in] hWnd

擁有對話框之視窗的句柄。這個參數可以是任何有效的視窗句柄，如果對話框沒有擁有者，則應 NULL。

[in, out] lpCC

COMMCONFIG 結構的指標。此結構包含呼叫前對話框的初始設定，並在呼叫之後變更值。

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

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

CommConfigDialog 函式需要通訊硬體廠商提供的動態連結庫（DLL）。

注意

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