ConnectToPrinterDlg-Funktion

Die ConnectToPrinterDlg-Funktion zeigt ein Dialogfeld an, in dem Benutzer Drucker in einem Netzwerk durchsuchen und eine Verbindung mit ihnen herstellen können. Wenn der Benutzer einen Drucker auswählt, versucht die Funktion, eine Verbindung damit herzustellen. Wenn auf dem Server kein geeigneter Treiber installiert ist, erhält 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.

Flags [ In]

Dieser Parameter ist reserviert und muss 0 (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ückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren für Druckertreiber ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion über einen Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, kann dazu bringen, dass die Anwendung scheinbar nicht reagiert.

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 ermitteln, ob die Funktion lokal einen Drucker erstellt hat, indem Sie GetPrinter mit einer PRINTER INFO _ _ 2-Struktur aufrufen und dann den Attributes-Member dieser Struktur untersuchen.

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.

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
WinSpool.drv

Weitere Informationen

Drucken

Druckspooler-API-Funktionen

AddPrinterConnection

ClosePrinter

DeletePrinter

DeletePrinterConnection

GetPrinter

DRUCKERINFORMATIONEN _ _ 2