IPrintDialogServices::GetCurrentPortName 方法 (commdlg.h)

检索要与 PrintDlgEx 一起使用的当前端口的名称。

语法

HRESULT GetCurrentPortName(
  LPWSTR pPortName,
  UINT   *pcchSize
);

参数

pPortName

类型: LPTSTR

当前端口的名称。

pcchSize

类型: UINT*

输入时, 变量指定 lpPortName 参数指向的缓冲区的大小(以字符为单位)。 输出时, 变量包含写入缓冲区的终止 null 字符 (ANSI) 或 unicode) (字符的字节数。

如果输入时的大小为零,则函数返回所需的缓冲区大小 (,以字节或字符为单位,) pcchSize 中,并且不使用 lpPortName 缓冲区。

返回值

类型: HRESULT

如果该方法成功,则返回值 S_OK。 如果没有当前端口,则返回值S_OK,pcchSize 中返回的值为零,lpPortName 缓冲区保持不变。

如果发生错误,则返回值为 COM 错误代码。 有关详细信息,请参阅错误处理

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 commdlg.h (包括 Windows.h)
DLL Comdlg32.dll

另请参阅

通用对话框库

概念性

IPrintDialogServices

PrintDlgEx

引用