Partager via


IPrintOemUI ::D evQueryPrintEx, méthode (prcomoem.h)

La méthode IPrintOemUI::DevQueryPrintEx 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 la structure DEVMODEW privée du plug-in d’interface utilisateur.

Valeur de retour

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

Retourner le code Description
S_OK
L’opération a réussi.
E_FAIL
L’opération a échoué.
E_NOTIMPL
La méthode n’est pas implémentée.

Remarques

La méthode IPrintOemUI::DevQueryPrintEx d’un plug-in d’interface utilisateur effectue les mêmes types d’opérations que la fonction DevQueryPrintEx exportée par des 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 responsabilité de la méthode IPrintOemUI::DevQueryPrintEx est 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 méthode IPrintOemUI::DevQueryPrintEx dans chaque plug-in d’interface utilisateur associée au pilote. Si toutes les méthodes IPrintOemUI::DevQueryPrintEx retournent S_OK, DevQueryPrintEx retourne TRUE. Par conséquent, un travail n’est pas imprimable, sauf si la fonction DevQueryPrintEx et toutes les méthodes IPrintOemUI::DevQueryPrintEx la déclarent être imprimables.

Si IPrintOemUI::DevQueryPrintEx 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’imprimantes microsoft.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête prcomoem.h (include Prcomoem.h)

Voir aussi

DevQueryPrintEx