Método IPrintOemPrintTicketProvider::GetSupportedVersions (prcomoem.h)
O método IPrintOemPrintTicketProvider::GetSupportedVersions recupera as principais versões dos esquemas de impressão compatíveis com o provedor de plug-in.
Sintaxe
HRESULT GetSupportedVersions(
[in] HANDLE hPrinter,
[out] INT * [] ppVersions,
[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
IPrintOemPrintTicketProvider::GetSupportedVersions deve retornar S_OK se a operação for bem-sucedida. Caso contrário, esse método deve retornar um código de erro COM padrão.
Comentários
IPrintOemPrintTicketProvider::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 não é responsável por liberar essa memória.
IPrintOemPrintTicketProvider::GetSupportedVersions pode ser chamado antes que o método IPrintOemPrintTicketProvider::BindPrinter seja chamado. Como resultado, o provedor de plug-in OEM não deve fechar o identificador de impressora associado ao parâmetro hPrinter .
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | prcomoem.h (inclua Prcomoem.h) |