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

Voir aussi

SHOWUIPARAMS

SplIsSessionZero