Metodo IPrintTicketProvider::GetSupportedVersions (prdrvcom.h)
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) |