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 Nichtzero-Wert.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Bemerkungen
Hinweis
Dies ist eine blockierende oder synchrone Funktion und wird möglicherweise nicht sofort zurückgegeben. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierungsfaktoren ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Wenn Sie diese Funktion über einen Thread aufrufen, der die Interaktion mit der Benutzeroberfläche verwaltet, kann die Anwendung nicht reagieren.
Wenn die ClosePrinter-Funktion zurückgegeben wird, ist der 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 Vorgehensweise: Drucken mithilfe der GDI-Druck-API.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|