Partager via


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