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

另请参阅

SplPromptUIInUsersSession