Metodo IPrintOemPrintTicketProvider::GetSupportedVersions (prcomoem.h)
Il metodo IPrintOemPrintTicketProvider::GetSupportedVersions recupera le versioni principali degli schemi di stampa supportati dal provider di 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 seguente.
[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.
Osservazioni
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::BindPrint er. Di conseguenza, il provider di plug-in OEM non deve chiudere l'handle della stampante associato al parametro hPrinter.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | prcomoem.h (include Prcomoem.h) |