Функция SplIsSessionZero (winsplp.h)
Функция SplIsSessionZero определяет, выдано ли определенное задание печати (маркер печати плюс идентификатор задания) в нулевом сеансе.
Синтаксис
DWORD SplIsSessionZero(
[in] HANDLE hPrinter,
DWORD JobId,
[out] BOOL *pIsSessionZero
);
Параметры
[in] hPrinter
Дескриптор принтера.
JobId
Указывает задание печати.
[out] pIsSessionZero
Указатель на расположение памяти, которое имеет значение TRUE , если sessionID для сеанса равен нулю; В противном случае этому значению присваивается значение FALSE.
Возвращаемое значение
При успешном выполнении функция SplIsSessionZero возвращает ERROR_SUCCESS; В противном случае эта функция возвращает код ошибки Win32.
Комментарии
Драйвер, отображающий пользовательские элементы пользовательского интерфейса, может использовать функцию SplIsSessionZero , чтобы определить, было ли выдано текущее задание в сеансе 0. Такой драйвер может использовать эти сведения, чтобы предоставить элементы пользовательского интерфейса в сеансе пользователя, а не в нулевом сеансе. Связанная функция SplPromptUIInUsersSession отображает стандартное окно сообщений Windows в сеансе пользователя.
Если вы планируете использовать эту функцию в драйвере, предназначенном для работы в Windows 2000, необходимо загрузить spoolss.dll путем вызова функции LoadLibrary , а затем найти адрес этой функции в этой библиотеке DLL путем вызова функции GetProcAddress . Если вызов GetProcAddress завершается сбоем , необходимо использовать альтернативный механизм для отображения элементов пользовательского интерфейса.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Эта функция доступна в Windows XP и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | winsplp.h (включая Winsplp.h) |
| Библиотека | Spoolss.lib |
| DLL | Spoolss.dll |