SplIsSessionZero, fonction (winsplp.h)
La fonction SplIsSessionZero détermine si un certain travail d’impression (handle d’impression plus ID de travail) a été émis dans session zéro.
Syntaxe
DWORD SplIsSessionZero(
[in] HANDLE hPrinter,
DWORD JobId,
[out] BOOL *pIsSessionZero
);
Paramètres
[in] hPrinter
Poignée de l’imprimante.
JobId
Spécifie le travail d’impression.
[out] pIsSessionZero
Pointeur vers un emplacement de mémoire défini sur TRUE si l’ID de session pour la session est égal à zéro ; sinon, cette valeur est définie sur FALSE.
Valeur de retour
En cas de réussite, la fonction SplIsSessionZero retourne ERROR_SUCCESS ; sinon, cette fonction retourne un code d’erreur Win32.
Remarques
Un pilote qui affiche des éléments d’interface utilisateur personnalisés peut utiliser la fonction SplIsSessionZero pour déterminer si le travail actuel a été émis dans la session 0. Ce pilote peut utiliser ces informations pour lui permettre de présenter des éléments d’interface utilisateur dans la session de l’utilisateur, plutôt que dans la session zéro. Une fonction associée, SplPromptUIInUsersSession, affiche une boîte de message Windows standard dans la session de l’utilisateur.
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 en appelant la fonction GetProcAddress. Si l’appel à GetProcAddress échoue, vous devez utiliser un autre mécanisme pour afficher les éléments d’interface utilisateur.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Cette fonction est disponible dans Windows XP et versions ultérieures. |
| plateforme cible | Bureau |
| d’en-tête | winsplp.h (include Winsplp.h) |
| bibliothèque | Spoolss.lib |
| DLL | Spoolss.dll |