Print Spooler API Functions

L’API Print Spooler contient les fonctions et les structures de données utilisées par les applications pour gérer le spouleur d’impression Windows et les imprimantes et les travaux d’impression qu’il contrôle.

Les fonctions de l’API Print Spooler sont divisées en groupes suivants :

• fonctions de travail d’impression
• fonctions d’interface utilisateur de l’imprimante
• fonctions d’imprimante
• fonctions de notification de modification de l’imprimante
• fonctions de formulaire d’imprimante
• Print Spooler Functions

Fonctions de travail d’impression

Ces fonctions envoient des travaux d’impression à une imprimante et effectuent le suivi et le contrôle des travaux d’impression dans le spouleur d’impression.

Fonction	Description
addJob	La fonction AddJob ajoute un travail d’impression à la liste des travaux d’impression qui peuvent être planifiés par le spouleur d’impression. La fonction récupère le nom du fichier que vous pouvez utiliser pour stocker le travail.
ClosePrinter	La fonction ClosePrinter ferme l’objet d’imprimante spécifié.
DocumentEvent	La fonction DocumentEvent est un gestionnaire d’événements pour les événements associés à l’impression d’un document.
DocumentProperties	La fonction DocumentProperties récupère ou modifie les informations d’initialisation de l’imprimante ou affiche une feuille de propriétés de configuration d’imprimante pour l’imprimante spécifiée.
EndDocPrinter	La fonction EndDocPrinter termine un travail d’impression pour l’imprimante spécifiée.
EndPagePrinter	La fonction EndPagePrinter informe le spouleur d’impression que l’application se trouve à la fin d’une page d’une tâche d’impression.
EnumJobs	La fonction EnumJobs récupère des informations sur un ensemble spécifié de travaux d’impression pour une imprimante spécifiée.
GetJob	La fonction GetJob récupère des informations sur un travail d’impression spécifié.
OpenPrinter	La fonction OpenPrinter récupère un handle sur l’imprimante ou le serveur d’impression spécifié ou d’autres types de handles dans le sous-système d’impression.
OpenPrinter2	Récupère un handle sur l’imprimante, le serveur d’impression ou d’autres types de handles dans le sous-système d’impression, tout en définissant certaines des options d’imprimante.
ReportJobProcessingProgress	Signale au service du spouleur d’impression s’il s’agit d’un travail d’impression XPS dans lepooling ou dans la phase de rendu et dans quelle partie du traitement est en cours.
scheduleJob	La fonction ScheduleJob demande que le spouleur d’impression planifie un travail d’impression spécifié pour l’impression.
SetJob	La fonction SetJob suspend, reprend, annule ou redémarre un travail d’impression sur une imprimante spécifiée. Vous pouvez également utiliser la fonction SetJob pour définir des paramètres de travail d’impression, tels que la priorité du travail d’impression et le nom du document.
StartDocPrinter	La fonction StartDocPrinter informe le spouleur d’impression qu’un document doit être mis en pool pour l’impression.
startPagePrinter	La fonction StartPagePrinter informe le spouleur qu’une page est sur le point d’être imprimée sur l’imprimante spécifiée.

Fonctions d’interface utilisateur de l’imprimante

Ces fonctions affichent une interface utilisateur qui permet à l’utilisateur de sélectionner ou de configurer une imprimante.

Fonction	Description
AdvancedDocumentProperties	La fonction AdvancedDocumentProperties affiche une boîte de dialogue de configuration d’imprimante pour l’imprimante spécifiée, ce qui permet à l’utilisateur de configurer cette imprimante.
ConfigurePort	La fonction ConfigurePort affiche la boîte de dialogue configuration de port pour un port sur le serveur spécifié.
ConnectToPrinterDlg	La fonction ConnectToPrinterDlg affiche une boîte de dialogue qui permet aux utilisateurs de parcourir et de se connecter à des imprimantes sur un réseau. Si l’utilisateur sélectionne une imprimante, la fonction tente de créer une connexion à celle-ci ; si un pilote approprié n’est pas installé sur le serveur, l’utilisateur a la possibilité de créer une imprimante localement.
PrinterProperties	La fonction PrinterProperties affiche une feuille de propriétés d’imprimante pour l’imprimante spécifiée.

Fonctions d’imprimante

Ces fonctions ajoutent et configurent les imprimantes utilisées par le spouleur d’impression.

Fonction	Description
AbortPrinter	La fonction AbortPrinter supprime le fichier depool d’une imprimante si l’imprimante est configurée pour le spoulage.
AddPrinter	La fonction AddPrinter ajoute une imprimante à la liste des imprimantes prises en charge pour un serveur spécifié.
addPrinterConnection	La fonction AddPrinterConnection ajoute une connexion à l’imprimante spécifiée pour l’utilisateur actuel.
AddPrinterConnection2	Ajoute une connexion à l’imprimante spécifiée pour l’utilisateur actuel et spécifie les détails de connexion.
deletePrinter	La fonction DeletePrinter supprime l’objet d’imprimante spécifié.
DeletePrinterConnection	La fonction DeletePrinterConnection supprime une connexion à une imprimante établie par un appel à AddPrinterConnection ou ConnectToPrinterDlg.
DeletePrinterData	La fonction DeletePrinterData supprime les données de configuration spécifiées pour une imprimante. Les données de configuration d’une imprimante se composent d’un ensemble de valeurs nommées et typées. La fonction DeletePrinterData supprime l’une de ces valeurs, spécifiée par son nom de valeur.
DeletePrinterDataEx	La fonction DeletePrinterDataEx supprime une valeur spécifiée des données de configuration d’une imprimante. Les données de configuration d’une imprimante se composent d’un ensemble de valeurs nommées et typées stockées dans une hiérarchie de clés de Registre. La fonction supprime une valeur spécifiée sous une clé spécifiée.
DeletePrinterKey	La fonction DeletePrinterKey supprime une clé spécifiée et toutes ses sous-clés pour une imprimante spécifiée.
EnumPrinterData	La fonction EnumPrinterData énumère les données de configuration d’une imprimante spécifiée.
EnumPrinterDataEx	La fonction EnumPrinterDataEx énumère tous les noms et données de valeur d’une imprimante et d’une clé spécifiées.
EnumPrinterKey	La fonction EnumPrinterKey énumère les sous-clés d’une clé spécifiée pour une imprimante spécifiée.
enumPrinters	La fonction EnumPrinters énumère les imprimantes disponibles, les serveurs d’impression, les domaines ou les fournisseurs d’impression.
FlushPrinter	La fonction FlushPrinter envoie une mémoire tampon à l’imprimante pour l’effacer d’un état temporaire.
GetDefaultPrinter	La fonction GetDefaultPrinter récupère le nom de l’imprimante par défaut de l’utilisateur actuel sur l’ordinateur local.
GetPrinter	La fonction GetPrinter récupère des informations sur une imprimante spécifiée.
GetPrinterData	La fonction GetPrinterData récupère les données de configuration pour l’imprimante ou le serveur d’impression spécifié.
GetPrinterDataEx	La fonction GetPrinterDataEx récupère les données de configuration pour l’imprimante ou le serveur d’impression spécifié. GetPrinterDataEx peut récupérer des valeurs stockées par la fonction SetPrinterData. En outre, GetPrinterDataEx peut récupérer des valeurs stockées sous une clé spécifiée par la fonction SetPrinterDataEx.
isValidDevmode	La fonction IsValidDevmode vérifie que le contenu d’une structure DEVMODE est valide.
ReadPrinter	La fonction ReadPrinter récupère les données de l’imprimante spécifiée.
ResetPrinter	La fonction ResetPrinter spécifie les valeurs de type de données et de mode appareil à utiliser pour l’impression de documents soumis par la fonction StartDocPrinter. Ces valeurs peuvent être remplacées à l’aide de la fonction SetJob une fois l’impression de document démarrée.
setDefaultPrinter	La fonction SetDefaultPrinter définit le nom de l’imprimante par défaut pour l’utilisateur actuel sur l’ordinateur local.
SetPort	La fonction SetPort définit l’état associé à un port d’imprimante.
SetPrinter	La fonction SetPrinter définit les données d’une imprimante spécifiée ou définit l’état de l’imprimante spécifiée en interrompant l’impression, en réactivant l’impression ou en désactivant tous les travaux d’impression.
SetPrinterData	La fonction SetPrinterData définit les données de configuration d’une imprimante ou d’un serveur d’impression.
SetPrinterDataEx	La fonction SetPrinterDataEx définit les données de configuration d’une imprimante ou d’un serveur d’impression. La fonction stocke les données de configuration sous la clé de Registre de l’imprimante.
WritePrinter	La fonction WritePrinter informe le spouleur d’impression que les données doivent être écrites dans l’imprimante spécifiée.

Fonctions de notification de modification de l’imprimante

Ces fonctions permettent à une application d’être avertie des modifications apportées à l’état d’une imprimante.

Fonction	Description
FindClosePrinterChangeNotification	La fonction FindClosePrinterChangeNotification ferme un objet de notification de modification créé en appelant la fonction FindFirstPrinterChangeNotification. L’imprimante ou le serveur d’impression associé à l’objet de notification de modification ne sera plus surveillé par cet objet.
FindFirstPrinterChangeNotification	La fonction FindFirstPrinterChangeNotification crée un objet de notification de modification et retourne un handle à l’objet. Vous pouvez ensuite utiliser ce handle dans un appel à l’une des fonctions d’attente pour surveiller les modifications apportées à l’imprimante ou au serveur d’impression.
FindNextPrinterChangeNotification	La fonction FindNextPrinterChangeNotification récupère des informations sur la notification de modification la plus récente pour un objet de notification de modification associé à une imprimante ou un serveur d’impression. Appelez cette fonction lorsqu’une opération d’attente sur l’objet de notification de modification est satisfaite.
FreePrinterNotifyInfo	La fonction FreePrinterNotifyInfo libère une mémoire tampon allouée par le système créée par la fonction FindNextPrinterChangeNotification.

Fonctions de formulaire d’imprimante

Ces fonctions gèrent les formulaires utilisés par une imprimante.

Fonction	Description
AddForm	La fonction AddForm ajoute un formulaire à la liste des formulaires disponibles qui peuvent être sélectionnés pour l’imprimante spécifiée.
DeleteForm	La fonction DeleteForm supprime un nom de formulaire de la liste des formulaires pris en charge.
EnumForms	La fonction EnumForms énumère les formulaires pris en charge par l’imprimante spécifiée.
GetForm	La fonction GetForm récupère des informations sur un formulaire spécifié.
SetForm	La fonction SetForm définit les informations de formulaire de l’imprimante spécifiée.

Imprimer les fonctions du spouleur

Ces fonctions interagissent avec le spouleur d’impression à un niveau bas.

Fonction	Description
CloseSpoolFileHandle	La fonction CloseSpoolFileHandle ferme un handle à un fichier depool associé au travail d’impression actuellement soumis par l’application.
CommitSpoolData	La fonction CommitSpoolData informe le spouleur d’impression qu’une quantité spécifiée de données a été écrite dans un fichier de spoulage spécifié et est prête à être rendue.
GetPrintExecutionData	La GetPrintExecutionData récupère le contexte d’impression actuel.
GetSpoolFileHandle	La fonction GetSpoolFileHandle récupère un handle pour le fichier depool associé au travail actuellement soumis par l’application.