Поделиться через


Функция 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

См. также раздел

SplPromptUIInUsersSession