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

Функция 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 ->bWait имеет значение FALSE, эта функция возвращает немедленно, не дожидаясь ответа пользователя. В этом случае параметр *pResponse имеет значение IDASYNC.

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

Требования

Требование	Значение
Минимальная версия клиента	Функция SplPromptUIInUsersSession доступна в Windows XP и более поздних версиях.
Целевая платформа	Персональный компьютер
Верхняя часть	winsplp.h (включая Winsplp.h)
Библиотека	Spoolss.lib
DLL	Spoolss.dll

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

SHOWUIPARAMS

SplIsSessionZero