Drucken von Spooler-API-Funktionen
Die Druckspooler-API enthält die Funktionen und Datenstrukturen, mit denen Anwendungen den Windows-Druckspooler und die Drucker und Druckaufträge verwalten, die sie steuert.
Die Funktionen der Druckspooler-API sind in die folgenden Gruppen unterteilt:
- Druckauftragsfunktionen
- Druckeroberflächenfunktionen
- Druckerfunktionen
- Druckeränderungsbenachrichtigungsfunktionen
- Druckerformularfunktionen
- Druckspoolerfunktionen
Druckauftragsfunktionen
Diese Funktionen senden Druckaufträge an einen Drucker und verfolgen und steuern die Druckaufträge im Druckspooler.
Funktion | Beschreibung |
---|---|
AddJob- |
Die AddJob--Funktion fügt der Liste der Druckaufträge, die vom Druckpooler geplant werden können, einen Druckauftrag hinzu. Die Funktion ruft den Namen der Datei ab, die Sie zum Speichern des Auftrags verwenden können. |
ClosePrinter- |
Die ClosePrinter--Funktion schließt das angegebene Druckerobjekt. |
DocumentEvent- |
Die DocumentEvent--Funktion ist ein Ereignishandler für Ereignisse, die mit dem Drucken eines Dokuments verbunden sind. |
DocumentProperties- |
Die DocumentProperties Funktion ruft Druckerinitialisierungsinformationen ab oder ändert sie oder zeigt ein Eigenschaftenblatt für die Druckerkonfiguration für den angegebenen Drucker an. |
EndDocPrinter- |
Die EndDocPrinter Funktion beendet einen Druckauftrag für den angegebenen Drucker. |
EndPagePrinter- |
Die EndPagePrinter- Funktion benachrichtigt den Druckspooler, dass sich die Anwendung am Ende einer Seite in einem Druckauftrag befindet. |
EnumJobs- |
Die EnumJobs--Funktion ruft Informationen zu einer bestimmten Gruppe von Druckaufträgen für einen angegebenen Drucker ab. |
GetJob- |
Die GetJob--Funktion ruft Informationen zu einem angegebenen Druckauftrag ab. |
OpenPrinter- |
Die OpenPrinter--Funktion ruft einen Handle an den angegebenen Drucker oder Druckserver oder andere Arten von Handles im Drucksubsystem ab. |
OpenPrinter2- |
Ruft einen Handle an den angegebenen Drucker, den Druckserver oder andere Arten von Ziehpunkten im Drucksubsystem ab, während einige der Druckeroptionen festgelegt werden. |
ReportJobProcessingProgress- |
Meldet dem Druckspoolerdienst, ob sich ein XPS-Druckauftrag in der Spooling- oder Renderingphase befindet und welcher Teil der Verarbeitung derzeit ausgeführt wird. |
ScheduleJob- |
Die ScheduleJob--Funktion fordert an, dass der Druckspooler einen angegebenen Druckauftrag für den Druck plant. |
SetJob- |
Die SetJob--Funktion hält an, fortbricht, abbricht oder startet einen Druckauftrag auf einem angegebenen Drucker neu. Sie können auch die SetJob--Funktion verwenden, um Druckauftragsparameter festzulegen, z. B. die Priorität des Druckauftrags und den Dokumentnamen. |
StartDocPrinter- |
Die StartDocPrinter- Funktion benachrichtigt den Druckspooler, dass ein Dokument zum Drucken gepoolt werden soll. |
StartPagePrinter- |
Die StartPagePrinter- Funktion benachrichtigt den Spooler, dass eine Seite auf dem angegebenen Drucker gedruckt werden soll. |
Druckerbenutzeroberflächenfunktionen
Diese Funktionen zeigen eine Benutzeroberfläche an, über die der Benutzer einen Drucker auswählen oder konfigurieren kann.
Funktion | Beschreibung |
---|---|
AdvancedDocumentProperties- |
Die AdvancedDocumentProperties--Funktion zeigt ein Dialogfeld zur Druckerkonfiguration für den angegebenen Drucker an, sodass der Benutzer diesen Drucker konfigurieren kann. |
ConfigurePort- |
Die ConfigurePort--Funktion zeigt das Dialogfeld "Portkonfiguration" für einen Port auf dem angegebenen Server an. |
ConnectToPrinterDlg- |
Die ConnectToPrinterDlg--Funktion zeigt ein Dialogfeld an, in dem Benutzer drucker in einem Netzwerk navigieren und eine Verbindung herstellen können. Wenn der Benutzer einen Drucker auswählt, versucht die Funktion, eine Verbindung damit herzustellen; Wenn auf dem Server kein geeigneter Treiber installiert ist, erhält der Benutzer die Möglichkeit, einen Drucker lokal zu erstellen. |
PrinterProperties- |
Die PrinterProperties--Funktion zeigt ein Eigenschaftenblatt mit Druckereigenschaften für den angegebenen Drucker an. |
Druckerfunktionen
Diese Funktionen fügen die Drucker hinzu, die der Druckspooler verwendet, und konfigurieren sie.
Funktion | Beschreibung |
---|---|
AbortPrinter- |
Die Funktion "AbortPrinter" löscht die Spooldatei eines Druckers, wenn der Drucker für das Spooling konfiguriert ist. |
AddPrinter- |
Die AddPrinter--Funktion fügt der Liste der unterstützten Drucker für einen angegebenen Server einen Drucker hinzu. |
AddPrinterConnection- |
Die AddPrinterConnection Funktion fügt dem angegebenen Drucker für den aktuellen Benutzer eine Verbindung hinzu. |
AddPrinterConnection2- |
Fügt dem angegebenen Drucker eine Verbindung für den aktuellen Benutzer hinzu und gibt Verbindungsdetails an. |
DeletePrinter- |
Die DeletePrinter- Funktion löscht das angegebene Druckerobjekt. |
DeletePrinterConnection- |
Die DeletePrinterConnection--Funktion löscht eine Verbindung mit einem Drucker, der durch einen Aufruf von AddPrinterConnection oder ConnectToPrinterDlgerstellt wurde. |
DeletePrinterData- |
Die DeletePrinterData-Funktion löscht angegebene Konfigurationsdaten für einen Drucker. Die Konfigurationsdaten eines Druckers bestehen aus einer Gruppe benannter und eingegebener Werte. Die DeletePrinterData--Funktion löscht einen dieser Werte, angegeben durch den Wertnamen. |
DeletePrinterDataEx- |
Die DeletePrinterDataEx-Funktion löscht einen angegebenen Wert aus den Konfigurationsdaten für einen Drucker. Die Konfigurationsdaten eines Druckers bestehen aus einer Gruppe benannter und typierter Werte, die in einer Hierarchie von Registrierungsschlüsseln gespeichert sind. Die Funktion löscht einen angegebenen Wert unter einem angegebenen Schlüssel. |
DeletePrinterKey- |
Die DeletePrinterKey--Funktion löscht einen angegebenen Schlüssel und alle Unterschlüssel für einen angegebenen Drucker. |
EnumPrinterData- |
Die EnumPrinterData-Funktion listet Konfigurationsdaten für einen angegebenen Drucker auf. |
EnumPrinterDataEx- |
Die EnumPrinterDataEx--Funktion listet alle Wertnamen und Daten für einen angegebenen Drucker und Schlüssel auf. |
EnumPrinterKey- |
Die EnumPrinterKey--Funktion listet die Unterschlüssel eines angegebenen Schlüssels für einen angegebenen Drucker auf. |
EnumPrinters |
Die EnumPrinters Funktion listet verfügbare Drucker, Druckserver, Domänen oder Druckanbieter auf. |
FlushPrinter- |
Die FlushPrinter--Funktion sendet einen Puffer an den Drucker, um ihn aus einem vorübergehenden Zustand zu löschen. |
GetDefaultPrinter- |
Die GetDefaultPrinter--Funktion ruft den Druckernamen des Standarddruckers für den aktuellen Benutzer auf dem lokalen Computer ab. |
GetPrinter- |
Die GetPrinter--Funktion ruft Informationen zu einem angegebenen Drucker ab. |
GetPrinterData- |
Die GetPrinterData--Funktion ruft Konfigurationsdaten für den angegebenen Drucker oder Druckserver ab. |
GetPrinterDataEx- |
Die GetPrinterDataEx-Funktion ruft Konfigurationsdaten für den angegebenen Drucker oder Druckserver ab.
GetPrinterDataEx- können werte abrufen, die von der SetPrinterData--Funktion gespeichert sind. Darüber hinaus können GetPrinterDataEx- Werte abrufen, die unter einem angegebenen Schlüssel gespeichert sind, indem die SetPrinterDataEx-funktion. |
IsValidDevmode- |
Die IsValidDevmode-Funktion überprüft, ob der Inhalt einer DEVMODE-Struktur gültig ist. |
ReadPrinter- |
Die ReadPrinter-Funktion ruft Daten vom angegebenen Drucker ab. |
ResetPrinter- |
Die funktion ResetPrinter gibt die Datentyp- und Gerätemoduswerte an, die für das Drucken von Dokumenten verwendet werden sollen, die von der StartDocPrinter--Funktion übermittelt werden. Diese Werte können mithilfe der SetJob--Funktion überschrieben werden, nachdem der Dokumentdruck gestartet wurde. |
SetDefaultPrinter- |
Die SetDefaultPrinter--Funktion legt den Druckernamen des Standarddruckers für den aktuellen Benutzer auf dem lokalen Computer fest. |
SetPort- |
Die SetPort--Funktion legt den Status fest, der einem Druckeranschluss zugeordnet ist. |
SetPrinter- |
Die SetPrinter--Funktion legt die Daten für einen angegebenen Drucker fest oder legt den Zustand des angegebenen Druckers fest, indem sie das Drucken anhalten, den Druck fortsetzen oder alle Druckaufträge löschen. |
SetPrinterData- |
Die SetPrinterData--Funktion legt die Konfigurationsdaten für einen Drucker oder Druckserver fest. |
SetPrinterDataEx- |
Die SetPrinterDataEx--Funktion legt die Konfigurationsdaten für einen Drucker oder Druckserver fest. Die Funktion speichert die Konfigurationsdaten unter dem Registrierungsschlüssel des Druckers. |
WritePrinter- |
Die WritePrinter- Funktion benachrichtigt den Druckspooler, dass Daten in den angegebenen Drucker geschrieben werden sollen. |
Druckeränderungsbenachrichtigungsfunktionen
Mit diesen Funktionen kann eine Anwendung über Änderungen am Status eines Druckers benachrichtigt werden.
Funktion | Beschreibung |
---|---|
FindClosePrinterChangeNotification |
Die funktion FindClosePrinterChangeNotification schließt ein Änderungsbenachrichtigungsobjekt, das durch Aufrufen der funktion FindFirstPrinterChangeNotification erstellt wurde. Der drucker- oder druckserver, der dem Änderungsbenachrichtigungsobjekt zugeordnet ist, wird nicht mehr von diesem Objekt überwacht. |
FindFirstPrinterChangeNotification- |
Die FindFirstPrinterChangeNotification--Funktion erstellt ein Änderungsbenachrichtigungsobjekt und gibt ein Handle an das Objekt zurück. Sie können dieses Handle dann in einem Aufruf einer der Wartefunktionen verwenden, um Änderungen am Drucker oder Druckserver zu überwachen. |
FindNextPrinterChangeNotification |
Die FindNextPrinterChangeNotification-Funktion ruft Informationen zur letzten Änderungsbenachrichtigung für ein Änderungsbenachrichtigungsobjekt ab, das einem Drucker oder Druckserver zugeordnet ist. Rufen Sie diese Funktion auf, wenn ein Wartevorgang für das Änderungsbenachrichtigungsobjekt erfüllt ist. |
FreePrinterNotifyInfo- |
Die FreePrinterNotifyInfo Funktion gibt einen vom System zugewiesenen Puffer frei, der von der FindNextPrinterChangeNotification-Funktion erstellt wurde. |
Druckerformularfunktionen
Diese Funktionen verwalten die von einem Drucker verwendeten Formulare.
Funktion | Beschreibung |
---|---|
AddForm- |
Die funktion AddForm fügt der Liste der verfügbaren Formulare, die für den angegebenen Drucker ausgewählt werden können, ein Formular hinzu. |
DeleteForm- |
Die DeleteForm-Funktion entfernt einen Formularnamen aus der Liste der unterstützten Formulare. |
EnumForms- |
Die EnumForms- Funktion listet die vom angegebenen Drucker unterstützten Formulare auf. |
GetForm- |
Die GetForm--Funktion ruft Informationen zu einem angegebenen Formular ab. |
SetForm- |
Die SetForm--Funktion legt die Formularinformationen für den angegebenen Drucker fest. |
Druckspoolerfunktionen
Diese Funktionen interagieren mit dem Druckspooler auf niedriger Ebene.
Funktion | Beschreibung |
---|---|
CloseSpoolFileHandle- |
Die CloseSpoolFileHandle--Funktion schließt ein Handle mit einer Spooldatei, die dem aktuell von der Anwendung übermittelten Druckauftrag zugeordnet ist. |
CommitSpoolData- |
Die CommitSpoolData- Funktion benachrichtigt den Druckspooler, dass eine angegebene Datenmenge in eine angegebene Spooldatei geschrieben wurde und bereit zum Rendern ist. |
GetPrintExecutionData- |
Die GetPrintExecutionData ruft den aktuellen Druckkontext ab. |
GetSpoolFileHandle- |
Die GetSpoolFileHandle--Funktion ruft ein Handle für die Spooldatei ab, die dem Auftrag zugeordnet ist, der derzeit von der Anwendung übermittelt wird. |