Méthode IPrintOemUI ::D evQueryPrintEx (prcomoem.h)

Article
02/26/2024

La IPrintOemUI::DevQueryPrintEx méthode permet à un plug-in d’interface utilisateur de déterminer si un travail d’impression est imprimable.

Syntaxe

HRESULT DevQueryPrintEx(
  POEMUIOBJ           poemuiobj,
  PDEVQUERYPRINT_INFO pDQPInfo,
  PDEVMODE            pPublicDM,
  PVOID               pOEMDM
);

Paramètres

poemuiobj

Pointeur fourni par l’appelant vers une structure OEMUIOBJ .

pDQPInfo

Pointeur fourni par l’appelant vers une structure DEVQUERYPRINT_INFO .

pPublicDM

Pointeur fourni par l’appelant vers une structure DEVMODEW validée.

pOEMDM

Pointeur fourni par l’appelant vers les membres de structure DEVMODEW privés du plug-in d’interface utilisateur.

Valeur retournée

La méthode doit retourner l’une des valeurs suivantes.

Code de retour	Description
S_OK	L’opération a réussi.
E_FAIL	L'opération a échoué.
E_NOTIMPL	Cette méthode n'est pas implémentée.

Remarques

La méthode d’un IPrintOemUI::DevQueryPrintEx plug-in d’interface utilisateur effectue les mêmes types d’opérations que la fonction DevQueryPrintEx exportée par les DLL d’interface d’imprimante en mode utilisateur. Vous pouvez utiliser cette méthode pour améliorer les fonctionnalités fournies par la fonction DevQueryPrintEx . Comme la fonction DevQueryPrintEx , la IPrintOemUI::DevQueryPrintEx méthode est responsable de déterminer si le travail d’impression décrit par la structure DEVMODEW fournie peut être imprimé.

Lorsque la fonction DevQueryPrintEx du pilote est appelée, elle vérifie la structure DEVMODEW, ainsi que les options d’imprimante actuellement sélectionnées, pour déterminer si le travail est imprimable. Si ce n’est pas le cas, la fonction retourne FALSE. Si le travail semble imprimable, la fonction appelle la IPrintOemUI::DevQueryPrintEx méthode dans chaque plug-in d’interface utilisateur associé au pilote. Si toutes les IPrintOemUI::DevQueryPrintEx méthodes retournent S_OK, DevQueryPrintEx retourne TRUE. Par conséquent, un travail n’est imprimable que si la fonction DevQueryPrintEx et toutes les IPrintOemUI::DevQueryPrintEx méthodes le déclarent imprimable.

Si IPrintOemUI::DevQueryPrintEx les méthodes sont exportées par plusieurs plug-ins d’interface utilisateur, les méthodes sont appelées dans l’ordre dans lequel les plug-ins sont spécifiés pour l’installation.

Pour plus d’informations sur la création et l’installation de plug-ins d’interface utilisateur, consultez Personnalisation des pilotes d’imprimante Microsoft.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	prcomoem.h (inclure Prcomoem.h)

Voir aussi

DevQueryPrintEx

Partager via