UploadPrinterDriverPackage-Funktion

Artikel
06/13/2023

Lädt einen Druckertreiber in den Treiberspeicher des Druckservers hoch, damit er installiert werden kann, indem InstallPrinterDriverFromPackage aufgerufen wird.

Syntax

HRESULT UploadPrinterDriverPackage(
  _In_    LPCTSTR pszServer,
  _In_    LPCTSTR pszInfPath,
  _In_    LPCTSTR pszEnvironment,
  _In_    DWORD   dwFlags,
  _In_    HWND    hwnd,
  _Out_   LPTSTR  pszDestInfPath,
  _Inout_ PULONG  pcchDestInfPath
);

Parameter

pszServer [in]

Ein Zeiger auf eine konstante, NULL-endende Zeichenfolge, die den Namen des Druckservers angibt. Verwenden Sie NULL , wenn der Server der lokale Computer ist.

pszInfPath [in]

Ein Zeiger auf eine konstante , null-terminierte Zeichenfolge, die den Quellpfad zur INF-Datei des Treibers angibt.

pszEnvironment [in]

Ein Zeiger auf eine konstante, NULL-endende Zeichenfolge, die die Prozessorarchitektur des Servers angibt (z. B. Windows NT x86). Dies kann NULL sein.

dwFlags [in]

Dies kann einer der folgenden Werte sein:

Wert	Bedeutung
UPDP_SILENT_UPLOAD	Die Benutzeroberfläche wird während des Uploads nicht angezeigt.
UPDP_UPLOAD_ALWAYS	Die Dateien werden auch dann hochgeladen, wenn sich das Paket bereits im Treiberspeicher des Servers befindet.
UPDP_CHECK_DRIVERSTORE	Der Treiberspeicher des Servers wird vor dem Upload überprüft, um festzustellen, ob das Paket bereits vorhanden ist. Diese Einstellung wird ignoriert, wenn UPDP_UPLOAD_ALWAYS festgelegt ist.

hwnd [in]

Ein Handle für die Kopier-Benutzeroberfläche.

pszDestInfPath [out]

Ein Zeiger auf den Zielpfad im Treiberspeicher, in den die INF-Datei des Treibers kopiert wurde.

pcchDestInfPath [in, out]

Gibt bei der Eingabe die Größe des pszDestInfPath-Puffers in Zeichen an. Empfängt bei der Ausgabe die Größe der Pfadzeichenfolge in Zeichen, einschließlich des abschließenden NULL-Zeichens.

Rückgabewert

Wenn der Vorgang erfolgreich ist, wird der Rückgabewert S_OK, andernfalls enthält das HRESULT einen Fehlercode.

Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung.

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 Treiberspeicher ist in der Regel %windir%\inf oder %windir%\System32\DriverStore\FileRepository.

Es kann jeweils nur ein Paket hochgeladen werden. Wenn ein Paket von anderen abhängig ist, müssen diese separat hochgeladen werden.

Nur signierte Treiberpakete können hochgeladen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Winspool.h (Einschließen von Windows.h)
Bibliothek	Winspool.lib
DLL	Spoolss.dll
Unicode- und ANSI-Name	UploadPrinterDriverPackageW (Unicode) und UploadPrinterDriverPackageA (ANSI)

Siehe auch

Drucken
Druckspooler-API-Funktionen

Freigeben über