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 |