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 auf NULL beendete Zeichenfolge, die den Namen des Servers angibt, auf dem der Druckprozessor installiert werden soll. Wenn dieser Parameter NULL ist, wird der Druckprozessor lokal installiert.

pUmgebung [ In]

Ein Zeiger auf eine auf NULL beendete 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 auf NULL beendete Zeichenfolge, die den Namen der Datei angibt, die den Druckprozessor enthält. Diese Datei muss sich im Systemverzeichnis für den Druckprozessor befinden.

pPrintProcessorName [ In]

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die den Namen des Druckprozessors angibt.

Rückgabewert

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Hinweis

Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückkehrt. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren des Druckertreibers 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 kommen, dass die Anwendung nicht reagiert.

Der Aufrufer muss über seLoadDriverPrivilege verfügen.

Vor dem Aufrufen der AddPrintProcessor-Funktion sollte eine Anwendung überprüfen, ob die Datei mit dem Druckprozessor im Druckprozessorverzeichnis des Systems gespeichert ist. Eine Anwendung kann den Namen des Druckprozessorverzeichnisses des Systems abrufen, indem die GetPrintProcessorDirectory-Funktion aufgerufen wird.

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
Winspool.h (include Windows.h)
Bibliothek
Winspool.lib
DLL
Winspool.drv
Unicode- und ANSI-Name
AddPrintProcessorW (Unicode) und AddPrintProcessorA (ANSI)

Weitere Informationen

Drucken

Druckspooler-API-Funktionen

EnumPrintProcessors

GetPrintProcessorDirectory