GetSpoolFileHandle-Funktion
Die GetSpoolFileHandle-Funktion ruft ein Handle für die Spooldatei ab, die dem aktuell von der Anwendung übermittelten Auftrag zugeordnet ist.
Syntax
HANDLE GetSpoolFileHandle(
_In_ HANDLE hPrinter
);
Parameter
-
hPrinter [ In]
-
Ein Handle für den Drucker, an den der Auftrag übermittelt wurde. Dies sollte dasselbe Handle sein, das zum Übermitteln des Auftrags verwendet wurde. (Verwenden Sie die OpenPrinter- oder AddPrinter-Funktion, um ein Druckerhand handle abzurufen.)
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ein Handle an die Spooldatei zurückgegeben.
Wenn die Funktion fehlschlägt, gibt sie INVALID _ HANDLE VALUE _ zurück.
Hinweise
Mit dem Handle für die Spooldatei kann Ihre Anwendung mit Aufrufen von WriteFile gefolgt von CommitSpoolData in die Spooldatei schreiben.
Ihre Anwendung darf ClosePrinter in hPrinter erst aufrufen, nachdem sie zum letzten Mal auf die Spooldatei zugegriffen hat. Anschließend sollte CloseSpoolFileHandle gefolgt von ClosePrinter genannt werden. Versuche, auf das Spooldateihand handle zu zugreifen, nachdem der ursprüngliche hPrinter geschlossen wurde, führen auch dann zu einem Fehler, wenn das Dateihand handle selbst nicht geschlossen wurde. CloseSpoolFileHandle selbst kann nicht verwendet werden, wenn ClosePrinter zuerst aufgerufen wird.
Diese Funktion kann nicht verwendet werden, wenn sie aufgerufen wird, bevor das Spoolen des Druckauftrags abgeschlossen ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
GetSpoolFileHandleW (Unicode) und GetSpoolFileHandleA (ANSI) |