Metodo IPrintTicketProvider::GetSupportedVersions (prdrvcom.h)

  • Articolo

Il metodo IPrintTicketProvider::GetSupportedVersions recupera i numeri di versione principali degli schemi di stampa supportati dal provider di plug-in.

Sintassi

HRESULT GetSupportedVersions(
  [in]  IN HANDLE    hPrinter,
  [out] OUT INT * [] ppVersions,
  [out] 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 seguente.

[out] cVersions

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

Valore restituito

IPrintTicketProvider::GetSupportedVersions deve restituire S_OK se l'operazione ha esito positivo. Se questo metodo ha esito negativo a causa della mancanza di memoria o di altre risorse, deve restituire un codice di errore COM standard.

Commenti

IPrintTicketProvider::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 le 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 Microsoft Windows SDK, ma il plug-in non è responsabile della liberazione di questa memoria.

Poiché IPrintTicketProvider::GetSupportedVersions può essere chiamato prima che venga chiamato il metodo IPrintTicketProvider::BindPrinter , il provider di plug-in OEM deve controllare il supporto della versione in base all'handle passato nel parametro hPrinter . Di conseguenza, il provider di plug-in OEM non deve chiudere l'handle della stampante associato a hPrinter.

Requisiti

Requisito Valore
Intestazione prdrvcom.h (include Prdrvcom.h)

Vedi anche

IPrintTicketProvider

IPrintTicketProvider::BindPrinter