Partager via


Fonction ScheduleJob

La fonction ScheduleJob demande que le spouleur d’impression planifie un travail d’impression spécifié pour l’impression.

Syntaxe

BOOL ScheduleJob(
  _In_ HANDLE hPrinter,
  _In_ DWORD  dwJobID
);

Paramètres

hPrinter [in]

Handle de l’imprimante pour le travail d’impression. Il doit s’agir d’une imprimante locale configurée en tant qu’imprimante en pool. Si hPrinter est un handle pour une connexion d’imprimante distante ou si l’imprimante est configurée pour l’impression directe, la fonction ScheduleJob échoue. Utilisez la fonction OpenPrinter ou AddPrinter pour récupérer un handle d’imprimante.

hPrinter doit être le même handle d’imprimante spécifié dans l’appel à AddJob qui a obtenu l’identificateur de travail dwJobID print.

dwJobID [in]

Travail d’impression à planifier. Vous obtenez cet identificateur de travail d’impression en appelant la fonction AddJob .

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Notes

Notes

Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et les facteurs d’implémentation du pilote d’imprimante qui sont difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut donner l’impression que l’application ne répond pas.

Vous devez appeler la fonction AddJob avant d’appeler la fonction ScheduleJob . AddJob obtient l’identificateur de travail d’impression que vous passez à ScheduleJob en tant que dwJobID. Les deux appels doivent utiliser la même valeur pour hPrinter.

La fonction ScheduleJob recherche un fichier de pool valide. S’il existe un fichier de spouleur non valide ou s’il est vide, ScheduleJob supprime à la fois le fichier de spouleur et l’entrée de travail d’impression correspondante dans le spouleur d’impression.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Winspool.h (inclure Windows.h)
Bibliothèque
Winspool.lib
DLL
Spoolss.dll

Voir aussi

Impression

Fonctions API du spouleur d’impression

AddJob

OpenPrinter