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