AddPrintProcessor-Funktion
Die AddPrintProcessor-Funktion installiert einen Druckprozessor auf dem angegebenen Server und fügt den Namen des Druckprozessors der Liste der unterstützten Druckprozessoren hinzu.
Syntax
BOOL AddPrintProcessor(
_In_ LPTSTR pName,
_In_ LPTSTR pEnvironment,
_In_ LPTSTR pPathName,
_In_ LPTSTR pPrintProcessorName
);
Parameter
-
pName [in]
-
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Servers angibt, auf dem der Druckprozessor installiert werden soll. Wenn dieser Parameter NULL ist, wird der Druckprozessor lokal installiert.
-
pEnvironment [in]
-
Ein Zeiger auf eine NULL-endende Zeichenfolge, die die Umgebung angibt (z. B. Windows x86, Windows IA64 oder Windows x64). Wenn dieser Parameter NULL ist, wird die aktuelle Umgebung des Aufrufers/Clients (nicht des Ziels/Servers) verwendet.
-
pPathName [in]
-
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen der Datei angibt, die den Druckprozessor enthält. Diese Datei muss sich im Systemdruckprozessorverzeichnis befinden.
-
pPrintProcessorName [in]
-
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Druckprozessors angibt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Bemerkungen
Hinweis
Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückgegeben wird. 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. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu führen, dass die Anwendung nicht mehr reagiert.
Der Aufrufer muss über das SeLoadDriverPrivilege verfügen.
Vor dem Aufrufen der AddPrintProcessor-Funktion sollte eine Anwendung überprüfen, ob die Datei, die den Druckprozessor enthält, im Systemdruckprozessorverzeichnis gespeichert ist. Eine Anwendung kann den Namen des Systemdruckprozessorverzeichnisses abrufen, indem sie die GetPrintProcessorDirectory-Funktion aufruft .
Eine Anwendung kann den Namen vorhandener Druckprozessoren ermitteln, indem sie die EnumPrintProcessors-Funktion aufruft .
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 |
AddPrintProcessorW (Unicode) und AddPrintProcessorA (ANSI) |