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 |