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 |
|
| Bibliothek |
|
| DLL |
|