AddPrinterConnection-Funktion

Die AddPrinterConnection-Funktion fügt dem angegebenen Drucker für den aktuellen Benutzer eine Verbindung hinzu.

Syntax

BOOL AddPrinterConnection(
  _In_ LPTSTR pName
);

Parameter

pName [ In]

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen eines Druckers angibt, mit dem der aktuelle Benutzer eine Verbindung herstellen möchte.

Rückgabewert

Wenn die Funktion erfolgreich ausgeführt wird, ist der Rückgabewert ein Wert ungleich 0 (null).

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ü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.

Wenn Windows eine Verbindung mit einem Drucker herstellen, müssen möglicherweise Druckertreiberdateien auf den Server kopiert werden, an den der Drucker angefügt ist. Wenn der Benutzer nicht über die Berechtigung zum Kopieren von Dateien an den entsprechenden Speicherort verfügt, schlägt die Funktion AddPrinterConnection fehl, und GetLastError gibt ERROR _ ACCESS _ DENIED zurück.

Eine Druckerverbindung, die durch Aufrufen von AddPrinterConnection hergestellt wird, wird aufzählt, wenn EnumPrinters aufgerufen wird, wobei dwType auf PRINTER _ ENUM CONNECTION festgelegt _ ist.

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
Unicode- und ANSI-Name
AddPrinterConnectionW (Unicode) und AddPrinterConnectionA (ANSI)

Weitere Informationen

Drucken

Druckspooler-API-Funktionen

ConnectToPrinterDlg

DeletePrinterConnection

EnumPrinters