InstallPrinterDriverFromPackage, fonction

Article
06/12/2023

Installe un pilote d’imprimante à partir d’un package de pilotes qui se trouve dans le magasin de pilotes du serveur d’impression.

Syntaxe

HRESULT InstallPrinterDriverFromPackage(
  _In_ LPCTSTR pszServer,
  _In_ LPCTSTR pszInfPath,
  _In_ LPCTSTR pszDriverName,
  _In_ LPCTSTR pszEnvironment,
  _In_ DWORD   dwFlags
);

Paramètres

pszServer [in]: Pointeur vers une chaîne constante terminée par null qui spécifie le nom du serveur d’impression. NULL signifie l’ordinateur local.
pszInfPath [in]: Pointeur vers une chaîne constante terminée par null qui spécifie le chemin du magasin de pilotes vers le fichier .inf du pilote d’impression. NULL signifie que le pilote se trouve dans un fichier inf fourni avec Windows.
pszDriverName [in]: Pointeur vers une chaîne constante terminée par null qui spécifie le nom du pilote.
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.
dwFlags [in]: Il ne peut s’agir que de 0 ou IPDFP_COPY_ALL_FILES. La valeur 0 signifie que le pilote d’imprimante doit être ajouté et que tous les fichiers du répertoire du pilote d’imprimante qui sont plus récents que les fichiers correspondants actuellement utilisés doivent être copiés. La valeur IPDFP_COPY_ALL_FILES signifie que le pilote d’imprimante et tous les fichiers du répertoire du pilote d’imprimante doivent être ajoutés. Les horodatages de fichier sont ignorés lorsque dwFlags a une valeur de IPDFP_COPY_ALL_FILES.

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.

Le magasin de pilotes est généralement %windir%\inf ou %windir%\System32\DriverStore\FileRepository.

InstallPrinterDriverFromPackage installe également d’autres fichiers dans le package, tels que les profils de couleur et les processeurs d’impression.

Les utilisateurs doivent disposer des droits d’administration de l’imprimante pour installer sur un ordinateur distant ou sur l’ordinateur local quand l’utilisateur est connecté à Terminal Services.

Seuls les packages signés peuvent être installés sur un ordinateur distant.

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	InstallPrinterDriverFromPackageW (Unicode) et InstallPrinterDriverFromPackageA (ANSI)

Voir aussi

Impression
Fonctions API du spouleur d’impression

Partager via