IPrintOemPrintTicketProvider ::GetSupportedVersions, méthode (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 du 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 du tableau pointé par *ppVersions.
Valeur de retour
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 responsable de l’allocation de la mémoire de tableau pointée par le paramètre ppVersions. Le plug-in doit allouer cette mémoire à l’aide de la fonction CoTaskMemAlloc (décrite dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows), mais elle n’est pas responsable de la libération de cette mémoire.
IPrintOemPrintTicketProvider ::GetSupportedVersions peut être appelé avant que la méthode IPrintOemPrintTicketProvider ::BindPrinter soit appelée. Par conséquent, le fournisseur de plug-in OEM ne doit pas fermer le handle d’imprimante associé au paramètre hPrinter.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | prcomoem.h (include Prcomoem.h) |