Metodo IPrintOemPrintTicketProvider::GetSupportedVersions (prcomoem.h)

  • Articolo

Il metodo IPrintOemPrintTicketProvider::GetSupportedVersions recupera le versioni principali degli schemi di stampa supportati dal provider plug-in.

Sintassi

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

Parametri

[in] hPrinter

Handle per il dispositivo di stampa.

[out] ppVersions

Puntatore a una variabile che riceve l'indirizzo del primo elemento di una matrice di numeri di versione. I numeri di versione nella matrice possono essere visualizzati in qualsiasi ordine. Per altre informazioni su questo parametro, vedere la sezione Osservazioni seguenti.

[out] cVersions

Puntatore a una variabile che riceve il numero di elementi nella matrice a cui punta *ppVersions.

Valore restituito

IPrintOemPrintTicketProvider::GetSupportedVersions deve restituire S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo deve restituire un codice di errore COM standard.

Commenti

IPrintOemPrintTicketProvider::GetSupportedVersions restituisce i numeri di versione principali degli schemi di stampa supportati dall'interfaccia del provider. (L'unico numero di versione attualmente definito è 1.) I provider possono omettere versioni intermedie.

Il plug-in è responsabile dell'allocazione della memoria della matrice a cui punta il parametro ppVersions . Il plug-in deve allocare questa memoria usando la funzione CoTaskMemAlloc (descritta nella documentazione di Microsoft Windows SDK), ma non è responsabile della liberazione di questa memoria.

È possibile chiamare IPrintOemPrintTicketProvider::GetSupportedVersions prima che venga chiamato il metodo IPrintOemPrintTicketProvider::BindPrinter. Di conseguenza, il provider di plug-in OEM non deve chiudere l'handle della stampante associato al parametro hPrinter .

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione prcomoem.h (include Prcomoem.h)

Vedi anche

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter