Método IPrintOemUI::UpgradePrinter (prcomoem.h)

Artigo
02/07/2025

O método IPrintOemUI::UpgradePrinter permite que um plug-in de interface do usuário atualize os valores de opção do dispositivo armazenados no registro.

Sintaxe

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

Parâmetros

dwLevel

Número de versão fornecida pelo chamador da estrutura apontada por pDriverUpgradeInfo. O valor válido atual é 1.

pDriverUpgradeInfo

Ponteiro fornecido pelo chamador para uma estrutura de DRIVER_UPGRADE_INFO_1.

Valor de retorno

O método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

Se você fornecer um plug-in de interface do usuário para um dos drivers de impressora da Microsoft e se o plug-in de interface do usuário armazenar valores de opção de dispositivo no registro, ele deverá implementar o método IPrintOemUI::UpgradePrinter para atualizar esses valores.

O método IPrintOemUI::UpgradePrinter de um plug-in de interface do usuário executa os mesmos tipos de operações que a função DrvUpgradePrinter exportada por DLLs de interface da impressora no modo de usuário. Quando a função DrvUpgradePrinter do driver é chamada, ela atualiza seus próprios valores de registro e, em seguida, chama o método IPrintOemUI::UpgradePrinter.

Se IPrintOemUI::UpgradePrinter métodos forem exportados por vários plug-ins de interface do usuário, os métodos serão chamados na ordem em que os plug-ins são especificados para instalação.

Para obter mais informações sobre como criar e instalar plug-ins de interface do usuário, consulte Personalizando os drivers de impressora da Microsoft.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Compartilhar via