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 |