共用方式為


SplIsSessionZero 函式 (winsplp.h)

SplIsSessionZero 函式會判斷特定列印作業是否 (列印句柄加上作業標識碼) 在會話零中發出。

語法

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