Método IPrintOemPrintTicketProvider::GetSupportedVersions (prcomoem.h)

2025-02-07

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 que é apontado por *ppVersions.

Valor de retorno

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.

Observações

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
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Consulte também

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter

Partilhar via