CommConfigDialogW 函式 (winbase.h)

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

語法

BOOL CommConfigDialogW(
  [in]      LPCWSTR      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 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。