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 |
|
| Bibliothèque |
|
| DLL |
|