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 |