ConnectToPrinterDlg-Funktion

Die ConnectToPrinterDlg-Funktion zeigt ein Dialogfeld an, in dem Benutzer Drucker in einem Netzwerk durchsuchen und eine Verbindung mit diesen herstellen können. Wenn der Benutzer einen Drucker auswählt, versucht die Funktion, eine Verbindung mit diesem herzustellen. wenn auf dem Server kein geeigneter Treiber installiert ist, hat der Benutzer die Möglichkeit, einen Drucker lokal zu erstellen.

Syntax

HANDLE ConnectToPrinterDlg(
  _In_ HWND  hwnd,
  _In_ DWORD Flags
);

Parameter

hwnd [in]

Gibt das übergeordnete Fenster des Dialogfelds an.

Flaggen [in]

Dieser Parameter ist reserviert und muss null sein.

Rückgabewert

Wenn die Funktion erfolgreich ist und der Benutzer einen Drucker auswählt, ist der Rückgabewert ein Handle für den ausgewählten Drucker.

Wenn die Funktion fehlschlägt oder der Benutzer das Dialogfeld abbricht, ohne einen Drucker auszuwählen, 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.

Die ConnectToPrinterDlg-Funktion versucht, eine Verbindung mit dem ausgewählten Drucker herzustellen. Wenn jedoch auf dem Server, auf dem sich der Drucker befindet, kein geeigneter Treiber installiert ist, bietet die Funktion dem Benutzer die Möglichkeit, einen Drucker lokal zu erstellen. Eine aufrufende Anwendung kann feststellen, ob die Funktion einen Drucker lokal erstellt hat, indem Sie GetPrinter mit einer PRINTER_INFO_2-Struktur aufruft und dann den Attribute-Member dieser Struktur untersucht.

Eine Anwendung sollte DeletePrinter aufrufen, um einen lokalen Drucker zu löschen. Eine Anwendung sollte DeletePrinterConnection aufrufen, um eine Verbindung mit einem Drucker zu löschen.

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

Siehe auch

Drucken

Druckspooler-API-Funktionen

AddPrinterConnection

ClosePrinter

DeletePrinter

DeletePrinterConnection

GetPrinter

PRINTER_INFO_2