SplPromptUIInUsersSession, fonction (winsplp.h)
La SplPromptUIInUsersSession fonction affiche une boîte de message standard dans la session indiquée par le handle d’imprimante et l’ID de travail.
Syntaxe
BOOL SplPromptUIInUsersSession(
[in] HANDLE hPrinter,
[in] DWORD JobId,
[in] PSHOWUIPARAMS pUIParams,
[out] DWORD *pResponse
);
Paramètres
[in] hPrinter
Gérez l’imprimante.
[in] JobId
Spécifie le travail d’impression.
[in] pUIParams
Pointeur vers une structure SHOWUIPARAMS qui contient des valeurs qui déterminent l’apparence et le comportement de la zone de message.
[out] pResponse
Pointeur vers un emplacement de mémoire qui contient la réponse de l’utilisateur ou la constante IDASYNC. Pour plus d'informations, consultez la section Notes.
Valeur retournée
En cas de réussite, la SplPromptUIInUsersSession fonction retourne TRUE ; sinon, elle retourne FALSE.
Remarques
Si pUIParams ->bWait a la valeur FALSE, cette fonction retourne immédiatement sans attendre la réponse de l’utilisateur. Dans ce cas, *pResponse est défini sur IDASYNC.
Si vous envisagez d’utiliser cette fonction dans un pilote destiné à s’exécuter sous Windows 2000, vous devez charger spoolss.dll par un appel à la fonction LoadLibrary , puis rechercher l’adresse de cette fonction dans cette DLL par un appel à la fonction GetProcAddress . (LoadLibrary et GetProcAddress sont décrits dans la documentation Microsoft Windows SDK.) Si l’appel à GetProcAddress échoue, vous devez utiliser un autre mécanisme pour afficher les éléments d’interface utilisateur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | La fonction SplPromptUIInUsersSession est disponible dans Windows XP et versions ultérieures |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | winsplp.h (inclure Winsplp.h) |
| Bibliothèque | Spoolss.lib |
| DLL | Spoolss.dll |