AddPrintProvidor-Funktion

Wichtig

Am 6. Juli 2021 hat KB5005010 eine optionale registrierungsbasierte Konfigurationsoption eingeführt, um den Zugriff auf diese API nur auf Administratorbenutzer zu beschränken. Diese Option war standardmäßig deaktiviert.

Am 10. August 2021 ändert KB5005652 den Standardwert dieser Konfiguration so, dass Administratorrechte zum Installieren neuer Druckertreiber erforderlich sind.

Die AddPrintProvidor-Funktion installiert einen lokalen Druckanbieter und verknüpft die Konfigurations-, Daten- und Anbieterdateien.

Syntax

BOOL AddPrintProvidor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pProviderInfo
);

Parameter

pName [in]

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Servers angibt, auf dem der Anbieter installiert werden soll. Für Systeme, die nur die lokale Installation von Anbietern unterstützen, sollte dieser Parameter NULL sein.

Ebene [in]

Die Ebene der Struktur, auf die pProviderInfo verweist. Dies kann eine der folgenden Sein.

Wert	Bedeutung
1	Die Funktion verwendet eine PROVIDOR_INFO_1-Struktur .
2	Die Funktion verwendet eine PROVIDOR_INFO_2-Struktur .

pProviderInfo [in]

Ein Zeiger auf eine Druckanbieterstruktur, wie von Level angegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.

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ückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierungsfaktoren ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Wenn Sie diese Funktion über einen Thread aufrufen, der die Interaktion mit der Benutzeroberfläche verwaltet, kann die Anwendung nicht reagieren.

Bevor eine Anwendung die AddPrintProvidor-Funktion aufruft, müssen alle vom Anbieter benötigten Dateien in das VERZEICHNIS SYSTEM32 kopiert werden.

Ein von AddPrintProvidor hinzugefügter Anbieter kann durch Aufrufen von DeletePrintProvidor entfernt werden.

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 (einschließlich Windows.h)
Bibliothek	Winspool.lib
DLL	Winspool.drv
Unicode- und ANSI-Name	AddPrintProvidorW (Unicode) und AddPrintProvidorA (ANSI)

Siehe auch

Drucken

Druckspooler-API-Funktionen

DeletePrintProvidor

PROVIDOR_INFO_1

PROVIDOR_INFO_2