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

Статья
02/07/2025

Функция SplPromptUIInUsersSession отображает стандартное окно сообщения в сеансе, указанное дескриптором принтера и идентификатором задания.

Синтаксис

BOOL SplPromptUIInUsersSession(
  [in]  HANDLE        hPrinter,
  [in]  DWORD         JobId,
  [in]  PSHOWUIPARAMS pUIParams,
  [out] DWORD         *pResponse
);

Параметры

[in] hPrinter

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

[in] JobId

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

[in] pUIParams

Указатель на структуру SHOWUIPARAMS, содержащую значения, определяющие внешний вид и поведение поля сообщения.

[out] pResponse

Указатель на расположение памяти, содержащее ответ пользователя или константу IDASYNC. Дополнительные сведения см. в разделе "Примечания".

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

При успешном выполнении функция SplPromptUIInUsersSession возвращает TRUE; в противном случае возвращается FALSE.

Замечания

Если pUIParams ->bWaitfalse, эта функция возвращается немедленно, не ожидая ответа пользователя. В этом случае *pResponse имеет значение IDASYNC.

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

Требования

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

См. также

SHOWUIPARAMS

SplIsSessionZero

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