Share via

SplIsSessionZero, fonction (winsplp.h)

  • Article

La fonction SplIsSessionZero détermine si un certain travail d’impression (handle d’impression plus ID de travail) a été émis dans la session zéro.

Syntaxe

DWORD SplIsSessionZero(
  [in]  HANDLE hPrinter,
        DWORD  JobId,
  [out] BOOL   *pIsSessionZero
);

Paramètres

[in] hPrinter

Handle de l’imprimante.

JobId

Spécifie le travail d’impression.

[out] pIsSessionZero

Pointeur vers un emplacement de mémoire défini sur TRUE si sessionID de la session est égal à zéro ; sinon, cette valeur est définie sur FALSE.

Valeur retournée

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. Un tel 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 par un appel à la fonction GetProcAddress . Si l’appel à GetProcAddress échoue, vous devez utiliser un autre mécanisme pour afficher les éléments de l’interface utilisateur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Cette fonction 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

SplPromptUIInUsersSession