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