Compartilhar via


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

O IPrintOemUI::UpgradePrinter método 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 fornecido pelo chamador da estrutura apontada por pDriverUpgradeInfo. O valor válido atual é 1.

pDriverUpgradeInfo

Ponteiro fornecido pelo chamador para uma estrutura DRIVER_UPGRADE_INFO_1 .

Retornar valor

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

Código de retorno Descrição
S_OK
A operação foi realizada com êxito.
E_FAIL
Falha na operação.
E_NOTIMPL
O método não está implementado.

Comentários

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 IPrintOemUI::UpgradePrinter método para atualizar esses valores.

O método de um plug-in de interface do IPrintOemUI::UpgradePrinter usuário executa os mesmos tipos de operações que a função DrvUpgradePrinter exportada por DLLs de interface de 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 IPrintOemUI::UpgradePrinter método .

Se IPrintOemUI::UpgradePrinter os 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 drivers de impressora da Microsoft.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)