GetPrinterDriverPackagePath-Funktion

Artikel
06/12/2023

Ruft den Pfad zum angegebenen Druckertreiberpaket auf einem Druckserver ab.

Syntax

HRESULT GetPrinterDriverPackagePath(
  _In_    LPCTSTR pszServer,
  _In_    LPCTSTR pszEnvironment,
  _In_    LPCTSTR pszLanguage,
  _In_    LPCTSTR pszPackageID,
  _Inout_ LPTSTR  pszDriverPackageCab,
  _In_    DWORD   cchDriverPackageCab,
  _Out_   LPDWORD pcchRequiredSize
);

Parameter

pszServer [in]: Ein Zeiger auf eine konstante NULL-Zeichenfolge, die den Namen des Druckservers angibt. Verwenden Sie NULL für den lokalen Computer.
pszEnvironment [in]: Ein Zeiger auf eine konstante NULL-Zeichenfolge, die die Prozessorarchitektur angibt (z. B. Windows NT x86). Dies kann NULL sein.
pszLanguage [in]: Ein Zeiger auf eine konstante, NULL-beendete Zeichenfolge, die die Sprache der mehrsprachigen Benutzeroberfläche für den zu installierenden Treiber angibt. Dies kann NULL sein.
pszPackageID [in]: Ein Zeiger auf eine konstante NULL-Zeichenfolge, die die ID des Treiberpakets angibt.
pszDriverPackageCab [in, out]: Ein Zeiger auf eine null-beendete Zeichenfolge, die den Pfad zur Ablagedatei für das Treiberpaket angibt. Dies kann NULL sein. Siehe Hinweise.
cchDriverPackageCab [in]: Die Größe des Puffers pszDriverPackageCab in Zeichen. Dies kann NULL sein.
pcchRequiredSize [out]: Ein Zeiger auf die erforderliche Größe des Puffers pszDriverPackageCab .

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 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.

Um einen Wert für cchDriverPackageCab abzurufen, rufen Sie die Funktion mit NULL als Wert von pszDriverPackageCab auf. Verwenden Sie den in pcchRequiredSize zurückgegebenen Wert als Wert von cchDriverPackageCab , und rufen Sie die Funktion erneut auf.

Die pszPackageID wird in der Regel von einem Aufruf von GetCorePrinterDrivers abgerufen.

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ßlich Windows.h)
Bibliothek	Winspool.lib
DLL	Spoolss.dll
Unicode- und ANSI-Name	GetPrinterDriverPackagePathW (Unicode) und GetPrinterDriverPackagePathA (ANSI)

Siehe auch

Drucken
Druckspooler-API-Funktionen

Freigeben über