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