CorePrinterDriverInstalled, fonction

Article
06/12/2023

La fonction CorePrinterDriverInstalled indique si un pilote d’imprimante principal avec un GUID, une date et une version spécifiés est installé.

Syntaxe

HRESULT CorePrinterDriverInstalled(
  _In_  LPCTSTR   pszServer,
  _In_  LPCTSTR   pszEnvironment,
  _In_  GUID      CoreDriverGUID,
  _In_  FILETIME  ftDriverDate,
  _In_  DWORDLONG dwlDriverVersion,
  _Out_ BOOL      *pbDriverInstalled
);

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). Cela peut être NULL.
CoreDriverGUID [in]: GUID du pilote d’imprimante principal.
ftDriverDate [in]: Date du pilote d’imprimante principal.
dwlDriverVersion [in]: Version du pilote d’imprimante de base.
pbDriverInstalled [out]: Pointeur vers TRUE si le pilote, ou une version plus récente, est installé, FALSE sinon.

Valeur retournée

Si l’opération réussit, la valeur de retour est S_OK, sinon le HRESULT contiendra 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.

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	CorePrinterDriverInstalledW (Unicode) et CorePrinterDriverInstalledA (ANSI)

Voir aussi

Impression
Fonctions API du spouleur d’impression

Partager via