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)

Confira também

IPrintTicketProvider

IPrintTicketProvider::BindPrinter