IPrintOemUI2 ::QueryJobAttributes, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintOemUI2::QueryJobAttributes permet à un plug-in d’interface utilisateur de post-traiter les résultats du pilote principal après un appel au DrvQueryJobAttributes DDI. Le plug-in peut choisir de remplacer les valeurs que le pilote principal a placées dans la mémoire tampon de sortie lpAttributeInfo.

Syntaxe

HRESULT QueryJobAttributes(
  HANDLE   hPrinter,
  PDEVMODE pDevmode,
  DWORD    dwLevel,
  LPBYTE   lpAttributeInfo
);

Paramètres

hPrinter

Spécifie le handle d’imprimante fourni par l’appelant.

pDevmode

Pointeur vers une structure de DEVMODEW fournie par l’appelant.

dwLevel

Spécifie une valeur fournie par l’appelant indiquant le type de structure pointé par lpAttributeInfo, comme indiqué dans le tableau suivant.

Valeur	Structure pointée par lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

Notez que si cette méthode modifie un dwDrvxxx membre des structures ATTRIBUTE_INFO_N, le spouleur suppose que le plug-in est en mesure de prendre en charge le comportement représenté par ce membre.

lpAttributeInfo

Pointeur vers un emplacement de mémoire qui reçoit l’adresse d’une structure du type identifié par dwLevel.

Valeur de retour

Si le plug-in d’interface utilisateur prend en charge cette méthode et que la méthode a réussi, elle doit retourner S_OK. Cela entraîne le retour du pilote principal TRUE pour les DrvQueryJobAttributes DDI. Si le plug-in d’interface utilisateur prend en charge cette méthode, mais que la méthode a échoué, elle doit retourner E_FAIL. Cela entraîne le retour du pilote principal FALSE pour DrvQueryJobAttributes DDI. Si le plug-in d’interface utilisateur ne prend pas en charge cette méthode, il doit retourner E_NOTIMPL.

Remarques

Lorsque l’imprimante a plusieurs plug-ins d’interface utilisateur installés, le pilote principal appelle les plug-ins d’interface utilisateur dans l’ordre dans lequel ils ont été installés. HrESULT retourné par le dernier plug-in d’interface utilisateur qui prend en charge cette méthode est utilisé pour déterminer la valeur de retour DrvQueryJobAttributes du pilote principal, comme décrit dans la section précédente.

Pour plus d’informations, consultez DrvQueryJobAttributes.