UpdatePrintDeviceObject, fonction (winsplp.h)

Avertissement

À compter de Windows 10, les API qui prennent en charge les fournisseurs d’impression tiers sont déconseillées. Microsoft ne recommande aucun investissement dans des fournisseurs d’impression tiers. En outre, sur les produits Windows 8 et plus récents où le modèle de pilote d’impression v4 est disponible, les fournisseurs d’impression tiers peuvent ne pas créer ou gérer de files d’attente qui utilisent des pilotes d’impression v4.

La fonction UpdatePrintDeviceObject met à jour les propriétés d’un objet d’appareil qui se trouve dans la file d’attente du fournisseur d’impression.

Syntaxe

HRESULT UpdatePrintDeviceObject(
  [in] HANDLE hPrinter,
  [in] HANDLE hDeviceObject
);

Paramètres

[in] hPrinter

HANDLE pour une imprimante ouverte. Il doit s’agir d’un handle retourné par les fonctions spouleur AddPrinter ou OpenPrinter .

[in] hDeviceObject

HANDLE de l’objet d’appareil à mettre à jour. Il doit s’agir d’un objet d’appareil créé avec AddPrintDeviceObject.

Valeur retournée

La fonction UpdatePrintDeviceObject retourne S_OK, si les propriétés de l’objet d’appareil ont été correctement mises à jour. Sinon, elle retourne une erreur.

Par exemple, cette fonction peut retourner HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), si l’appel de fonction a été effectué avec un HANDLE non valide, ou si l’objet d’appareil a été supprimé avant l’appel de fonction.

Remarques

La structure PRINTER_INFO_2 est un bon exemple du type de propriétés que UpdatePrintDeviceObject peut mettre à jour.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	winsplp.h (include Winspool.h)
Bibliothèque	WinSpool.lib
DLL	WinSpool.drv

Voir aussi

AddPrintDeviceObject

PRINTER_INFO_2