RemovePrintDeviceObject, 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 Windows 8 et les produits 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 RemovePrintDeviceObject supprime un objet d’appareil d’une file d’attente du fournisseur d’impression.

Syntaxe

HRESULT RemovePrintDeviceObject(
  [in] HANDLE hDeviceObject
);

Paramètres

[in] hDeviceObject

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

Valeur retournée

La fonction RemovePrintDeviceObject retourne S_OK, si l’objet d’appareil a été supprimé avec succès. Sinon, elle retourne une erreur.

Par exemple, cette fonction peut retourner HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), si un handle d’objet d’appareil non valide a été utilisé pour appeler la fonction. Notez également que, quelle que soit la valeur de retour, l’objet d’appareil HANDLE devient non valide une fois qu’un appel à RemovePrintDeviceObject est terminé.

Remarques

Appelez RemovePrintDeviceObject pour supprimer l’objet d’appareil d’une imprimante qui a été supprimée. Lorsque les services de spouleur s’arrêtent, tous les objets d’appareil sont automatiquement supprimés. Il n’est donc pas nécessaire d’appeler RemovePrintDeviceObject pour chaque objet d’appareil d’imprimante.

Configuration requise

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

Voir aussi

AddPrintDeviceObject