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 einen Druckerhandle abzurufen.)
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie ein Handle an die Spooldatei zurück.
Wenn die Funktion fehlschlägt, gibt sie INVALID_HANDLE_VALUE zurück.
Bemerkungen
Mit dem Handle für die Spooldatei kann Ihre Anwendung in die Spooldatei schreiben, wobei WriteFile gefolgt von CommitSpoolData aufgerufen wird.
Ihre Anwendung darf ClosePrinter erst auf hPrinter aufrufen, nachdem sie zum letzten Mal auf die Spooldatei zugegriffen hat. Anschließend sollte CloseSpoolFileHandle gefolgt von ClosePrinter aufgerufen werden. Versuche, auf das Spooldateihandle zuzugreifen, nachdem der ursprüngliche hPrinter geschlossen wurde, schlagen auch dann fehl, wenn das Dateihandle selbst nicht geschlossen wurde. CloseSpoolFileHandle schlägt selbst fehl, wenn ClosePrinter zuerst aufgerufen wird.
Diese Funktion schlägt fehl, wenn sie aufgerufen wird, bevor der Druckauftrag das Spooling abgeschlossen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
GetSpoolFileHandleW (Unicode) und GetSpoolFileHandleA (ANSI) |