Método IPrintTicketProvider::GetSupportedVersions (prdrvcom.h)
O método IPrintTicketProvider::GetSupportedVersions recupera os principais números de versão dos esquemas de impressão compatíveis com o provedor de plug-in.
Sintaxe
HRESULT GetSupportedVersions(
[in] IN HANDLE hPrinter,
[out] OUT INT * [] ppVersions,
[out] OUT INT *cVersions
);
Parâmetros
[in] hPrinter
Um identificador para o dispositivo de impressão.
[out] ppVersions
Um ponteiro para uma variável que recebe o endereço do primeiro elemento de uma matriz de números de versão. Os números de versão na matriz podem aparecer em qualquer ordem. Para obter mais informações sobre esse parâmetro, consulte a seção Comentários a seguir.
[out] cVersions
Um ponteiro para uma variável que recebe o número de elementos na matriz apontada por ppVersions.
Retornar valor
IPrintTicketProvider::GetSupportedVersions deverá retornar S_OK se a operação for bem-sucedida. Se esse método falhar devido à falta de memória ou outros recursos, ele deverá retornar um código de erro COM padrão.
Comentários
IPrintTicketProvider::GetSupportedVersions retorna os principais números de versão dos esquemas de impressão compatíveis com a interface do provedor. O único número de versão definido no momento é 1. Os provedores podem omitir versões intermediárias.
O plug-in é responsável por alocar a memória da matriz apontada pelo parâmetro ppVersions . O plug-in deve alocar essa memória usando a função CoTaskMemAlloc descrita na documentação do SDK do Microsoft Windows, mas o plug-in não é responsável por liberar essa memória.
Como IPrintTicketProvider::GetSupportedVersions pode ser chamado antes que o método IPrintTicketProvider::BindPrinter seja chamado, o provedor de plug-in OEM deve marcar suporte à versão com base no identificador passado no parâmetro hPrinter. Como resultado, o provedor de plug-in OEM não deve fechar o identificador de impressora associado ao hPrinter.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | prdrvcom.h (inclua Prdrvcom.h) |