Méthode IPrintTicketProvider2 ::GetSupportedVersions (prdrvcom.h)

La méthode IPrintTicketProvider2 ::GetSupportedVersions récupère les numéros de version principaux des schémas d’impression pris en charge par le fournisseur de plug-in.

Syntaxe

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

Paramètres

[in] hPrinter

Poignée 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

IPrintTicketProvider2 ::GetSupportedVersions doit retourner S_OK si l’opération réussit. Si cette méthode échoue en raison d’un manque de mémoire ou d’autres ressources, elle doit retourner un code d’erreur COM standard.

Remarques

IPrintTicketProvider2 ::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 responsable de l’allocation de la mémoire de 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 le plug-in n’est pas responsable de libérer cette mémoire.

Étant donné que IPrintTicketProvider2 ::GetSupportedVersions peut être appelé avant l’appel de la méthode IPrintTicketProvider2 ::BindPrinter, le fournisseur de plug-in OEM doit case activée prise en charge des versions en fonction du handle passé dans le paramètre hPrinter. Par conséquent, le fournisseur de plug-in OEM ne doit pas fermer le handle d’imprimante associé à hPrinter.

Configuration requise

Voir aussi

IPrintTicketProvider2

IPrintTicketProvider2 ::BindPrinter