GetPrinterDriverPackagePath, fonction

Article
06/12/2023

Récupère le chemin d’accès au package de pilote d’imprimante spécifié sur un serveur d’impression.

Syntaxe

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

Paramètres

pszServer [in]: Pointeur vers une chaîne constante terminée par null qui spécifie le nom du serveur d’impression. Utilisez NULL pour l’ordinateur local.
pszEnvironment [in]: Pointeur vers une chaîne constante terminée par null qui spécifie l’architecture du processeur (par exemple, Windows NT x86). Il peut s’agir de NULL.
pszLanguage [in]: Pointeur vers une chaîne constante terminée par null qui spécifie la langue de l’interface utilisateur multilingue pour le pilote en cours d’installation. Il peut s’agir de NULL.
pszPackageID [in]: Pointeur vers une chaîne constante terminée par null qui spécifie l’ID du package de pilotes.
pszDriverPackageCab [in, out]: Pointeur vers une chaîne terminée par null qui spécifie le chemin d’accès au fichier d’armoire pour le package de pilotes. Il peut s’agir de NULL. Consultez la section Notes.
cchDriverPackageCab [in]: Taille, en caractères, de la mémoire tampon pszDriverPackageCab . Il peut s’agir de NULL.
pcchRequiredSize [out]: Pointeur vers la taille requise de la mémoire tampon pszDriverPackageCab .

Valeur retournée

Si l’opération réussit, la valeur de retour est S_OK, sinon le HRESULT contient un code d’erreur.

Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs.

Notes

Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et les facteurs d’implémentation du pilote d’imprimante qui sont difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut donner l’impression que l’application ne répond pas.

Pour obtenir une valeur pour cchDriverPackageCab, appelez la fonction avec NULL comme valeur de pszDriverPackageCab. Utilisez la valeur retournée dans pcchRequiredSize comme valeur de cchDriverPackageCab et appelez à nouveau la fonction.

Le pszPackageID est généralement obtenu à partir d’un appel à GetCorePrinterDrivers.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	Winspool.h (inclure Windows.h)
Bibliothèque	Winspool.lib
DLL	Spoolss.dll
Noms Unicode et ANSI	GetPrinterDriverPackagePathW (Unicode) et GetPrinterDriverPackagePathA (ANSI)

Voir aussi

Impression
Fonctions API du spouleur d’impression

Partager via