Функция SplIsSessionZero (winsplp.h)

Статья
02/07/2025

Функция SplIsSessionZero определяет, было ли выдано определенное задание печати (дескриптор печати и идентификатор задания) в сеансе ноль.

Синтаксис

DWORD SplIsSessionZero(
  [in]  HANDLE hPrinter,
        DWORD  JobId,
  [out] BOOL   *pIsSessionZero
);

Параметры

[in] hPrinter

Дескриптор принтера.

JobId

Указывает задание печати.

[out] pIsSessionZero

Указатель на расположение памяти, которое имеет значение TRUE, если значение SessionID для сеанса равно нулю; в противном случае это значение равно FALSE.

Возвращаемое значение

При успешном выполнении функция SplIsSessionZer o возвращает ERROR_SUCCESS; в противном случае эта функция возвращает код ошибки Win32.

Замечания

Драйвер, отображающий пользовательские элементы пользовательского интерфейса, может использовать функцию SplIsSessionZero, чтобы определить, выдано ли текущее задание в сеансе 0. Такой драйвер может использовать эти сведения, чтобы он мог представлять элементы пользовательского интерфейса в сеансе пользователя, а не в нуле сеанса. Связанная функция SplPromptUIInUsersSessionотображает стандартное окно сообщений Windows в сеансе пользователя.

Если вы планируете использовать эту функцию в драйвере, предназначенном для запуска в Windows 2000, необходимо загрузить spoolss.dll вызовом функции loadLibrary LoadLibrary, а затем найти адрес этой функции в этой библиотеке DLL путем вызова функции GetProcAddress. Если вызов GetProcAddress завершается ошибкой, необходимо использовать альтернативный механизм для отображения элементов пользовательского интерфейса.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Эта функция доступна в Windows XP и более поздних версиях.
целевая платформа	Настольный
заголовка	winsplp.h (include Winsplp.h)
библиотеки	Spoolss.lib
DLL	Spoolss.dll

См. также

SplPromptUIInUsersSession

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