GetCorePrinterDrivers, fonction

Article
06/12/2023

Récupère le GUID, la version et la date des pilotes d’imprimante principaux spécifiés, ainsi que le chemin d’accès à leurs packages.

Syntaxe

HRESULT GetCorePrinterDrivers(
  _In_  LPCTSTR              pszServer,
  _In_  LPCTSTR              pszEnvironment,
  _In_  LPCTSTR              pszzCoreDriverDependencies,
  _In_  DWORD                cCorePrinterDrivers,
  _Out_ PCORE_PRINTER_DRIVER pCorePrinterDrivers
);

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.
pszzCoreDriverDependencies [in]: Pointeur vers une chaîne multi string terminée par null qui spécifie les GUID des pilotes d’imprimante principaux.
cCorePrinterDrivers [in]: Nombre de chaînes dans pszzCoreDriverDependencies.
pCorePrinterDrivers [out]: Pointeur vers un tableau d’une ou plusieurs structures CORE_PRINTER_DRIVER .

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	GetCorePrinterDriversW (Unicode) et GetCorePrinterDriversA (ANSI)

Voir aussi

Impression
Fonctions API du spouleur d’impression

Partager via