Partager via


Méthode IPrintOemPrintTicketProvider ::GetSupportedVersions (prcomoem.h)

La méthode IPrintOemPrintTicketProvider ::GetSupportedVersions récupère les versions principales des schémas d’impression pris en charge par le fournisseur de plug-in.

Syntaxe

HRESULT GetSupportedVersions(
  [in]  HANDLE   hPrinter,
  [out] INT * [] ppVersions,
  [out] INT      *cVersions
);

Paramètres

[in] hPrinter

Handle de l’appareil d’impression.

[out] ppVersions

Pointeur vers une variable qui reçoit l’adresse du premier élément d’un tableau de numéros de version. Les numéros de version dans le tableau peuvent apparaître dans n’importe quel ordre. Pour plus d’informations sur ce paramètre, consultez la section Remarques suivante.

[out] cVersions

Pointeur vers une variable qui reçoit le nombre d’éléments dans le tableau pointé par *ppVersions.

Valeur retournée

IPrintOemPrintTicketProvider ::GetSupportedVersions doit retourner S_OK si l’opération réussit. Sinon, cette méthode doit retourner un code d’erreur COM standard.

Remarques

IPrintOemPrintTicketProvider ::GetSupportedVersions retourne les numéros de version principaux des schémas d’impression pris en charge par l’interface du fournisseur. (Le seul numéro de version actuellement défini est 1.) Les fournisseurs peuvent omettre les versions intermédiaires.

Le plug-in est chargé d’allouer la mémoire du tableau vers laquelle pointe le paramètre ppVersions . Le plug-in doit allouer cette mémoire à l’aide de la fonction CoTaskMemAlloc (décrite dans la documentation Microsoft Windows SDK), mais il n’est pas responsable de libérer cette mémoire.

IPrintOemPrintTicketProvider ::GetSupportedVersions peut être appelé avant l’appel de la méthode IPrintOemPrintTicketProvider ::BindPrinter . Par conséquent, le fournisseur de plug-in OEM ne doit pas fermer la poignée d’imprimante associée au paramètre hPrinter .

Configuration requise

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

Voir aussi

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider ::BindPrinter