SplPromptUIInUsersSession 函数 (winsplp.h)

  • 项目

函数 SplPromptUIInUsersSession 在打印机句柄和作业 ID 指示的会话中显示一个标准消息框。

语法

BOOL SplPromptUIInUsersSession(
  [in]  HANDLE        hPrinter,
  [in]  DWORD         JobId,
  [in]  PSHOWUIPARAMS pUIParams,
  [out] DWORD         *pResponse
);

参数

[in] hPrinter

打印机的句柄。

[in] JobId

指定打印作业。

[in] pUIParams

指向 SHOWUIPARAMS 结构的指针，该结构包含确定消息框的外观和行为的值。

[out] pResponse

指向包含用户响应或 IDASYNC 常量的内存位置的指针。 有关详细信息，请参见“备注”部分。

返回值

成功后，函数 SplPromptUIInUsersSession 返回 TRUE;否则返回 FALSE。

注解

如果 pUIParams ->bWait 为 FALSE，则此函数将立即返回，而无需等待用户的响应。 在这种情况下，*pResponse 设置为 IDASYNC。

如果计划在打算在 Windows 2000 下运行的驱动程序中使用此函数，则必须通过调用 LoadLibrary 函数加载 spoolss.dll，然后通过调用 GetProcAddress 函数在该 DLL 中查找此函数的地址。 (LoadLibrary 和 GetProcAddress 在 Microsoft Windows SDK 文档中介绍。) 如果对 GetProcAddress 的调用失败，则必须使用替代机制来显示用户界面元素。

要求

要求 值
最低受支持的客户端 SplPromptUIInUsersSession 函数在 Windows XP 及更高版本中可用
目标平台 桌面
标头 winsplp.h (包括 Winsplp.h)
Library Spoolss.lib
DLL Spoolss.dll

另请参阅

SHOWUIPARAMS

SplIsSessionZero