SetDefaultPrinter-Funktion

Die SetDefaultPrinter-Funktion legt den Druckernamen des Standarddruckers für den aktuellen Benutzer auf dem lokalen Computer fest.

Syntax

BOOL SetDefaultPrinter(
  _In_ LPCTSTR pszPrinter
);

Parameter

pszPrinter [in]

Ein Zeiger auf eine NULL-Zeichenfolge, die den Standarddruckernamen enthält. Bei einer Remotedruckerverbindung lautet das Namensformat **\\server\**printername. Für einen lokalen Drucker lautet das Namensformat printername.

Wenn dieser Parameter NULL oder eine leere Zeichenfolge ist, also "", wählt SetDefaultPrinter einen Standarddrucker aus einem der installierten Drucker aus. Wenn bereits ein Standarddrucker vorhanden ist, kann das Aufrufen von SetDefaultPrinter mit null oder einer leeren Zeichenfolge in diesem Parameter den Standarddrucker ändern.

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

Wenn Sie diese Methode verwenden, müssen Sie einen gültigen Drucker, Treiber und Port angeben. Wenn sie ungültig sind, schlagen die APIs nicht fehl, aber das Ergebnis ist nicht definiert. Dies kann dazu führen, dass andere Programme den Drucker wieder auf den vorherigen gültigen Drucker zurücksetzen. Sie können EnumPrinters verwenden, um den Druckernamen, den Treibernamen und den Portnamen aller verfügbaren Drucker abzurufen.

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.

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

Siehe auch

Drucken

Druckspooler-API-Funktionen

EnumPrinters

GetDefaultPrinter