ClosePrinter-Funktion

Die ClosePrinter-Funktion schließt das angegebene Druckerobjekt.

Syntax

BOOL ClosePrinter(
  _In_ HANDLE hPrinter
);

Parameter

hPrinter [ In]

Ein Handle für das zu schließende Druckerobjekt. Dieses Handle wird von der OpenPrinter- oder AddPrinter-Funktion zurückgegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich 0 (null).

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Bemerkungen

Hinweis

Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückkehrt. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren des Druckertreibers ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu kommen, dass die Anwendung nicht reagiert.

Wenn die ClosePrinter-Funktion zurückgegeben wird, ist das Handle hPrinter ungültig, unabhängig davon, ob die Funktion erfolgreich war oder fehlgeschlagen ist.

Beispiele

Ein Beispielprogramm, das diese Funktion verwendet, finden Sie unter How To: Print Using the GDI Print API (How To: Drucken mithilfe der GDI-Druck-API).

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Winspool.h (include Windows.h)
Bibliothek
Winspool.lib
DLL
Spoolss.dll

Weitere Informationen

Drucken

Druckspooler-API-Funktionen

AddPrinter

OpenPrinter