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

Siehe auch

Drucken

Druckspooler-API-Funktionen

OpenPrinter

AddPrinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData