SplIsSessionZero 函数 (winsplp.h)
SplIsSessionZero 函数确定某个打印作业(打印句柄加作业 ID)是否在 会话零中发出。
语法
DWORD SplIsSessionZero(
[in] HANDLE hPrinter,
DWORD JobId,
[out] BOOL *pIsSessionZero
);
参数
[in] hPrinter
打印机的句柄。
JobId
指定打印作业。
[out] pIsSessionZero
指向如果会话的 SessionID 为零,则指向设置为 TRUE 的内存位置的指针;否则,此值设置为 FALSE。
返回值
成功后,SplIsSessionZero 函数返回 ERROR_SUCCESS;否则,此函数返回 Win32 错误代码。
言论
显示自定义用户界面元素的驱动程序可以使用 SplIsSessionZero 函数来确定当前作业是否在会话 0 中发出。 此类驱动程序可以使用此信息来显示用户会话中的用户界面元素,而不是在会话零中显示。 相关函数 SplPromptUIInUsersSession,在用户的会话中显示标准 Windows 消息框。
如果计划在要在 Windows 2000 下运行的驱动程序中使用此函数,则必须通过调用 LoadLibrary 函数来加载 spoolss.dll,然后通过调用 getProcAddress 函数来在该 DLL 中找到此函数的地址。 如果调用 GetProcAddress 失败,则必须使用替代机制来显示用户界面元素。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 此函数在 Windows XP 及更高版本中可用。 |
目标平台 | 桌面 |
标头 | winsplp.h (包括 Winsplp.h) |
库 | Spoolss.lib |
DLL | Spoolss.dll |