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 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。