SplIsSessionZero 函数 (winsplp.h)

  • 项目

SplIsSessionZero 函数确定某个打印作业 (打印句柄加上作业 ID) 是否在会话 0 中发出。

语法

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)
Library Spoolss.lib
DLL Spoolss.dll

另请参阅

SplPromptUIInUsersSession