AddPrintProvidor-Funktion
Wichtig
Am 6. Juli 2021 wurde in KB5005010 eine optionale registrierungsbasierte Konfigurationsoption eingeführt, mit der der Zugriff auf diese API nur auf Administratoren beschränkt werden kann. 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 Funktion AddPrintProvidor 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 auf NULL endende 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 einer 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 durch Ebene angegeben.
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.
Hinweise
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.
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 DeletePrintProvidorentfernt 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) |