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
Winspool.h (include Windows.h)
Bibliothek
Winspool.lib
DLL
WinSpool.drv
Unicode- und ANSI-Name
GetSpoolFileHandleW (Unicode) und GetSpoolFileHandleA (ANSI)

Weitere Informationen

Drucken

Druckspooler-API-Funktionen

OpenPrinter

AddPrinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData