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