Compartilhar via


Função DrvUpgradePrinter (winddiui.h)

A função DrvUpgradePrinter de uma interface de impressora é usada para atualizar as configurações do Registro de uma impressora quando uma nova versão do driver é adicionada a um sistema.

Sintaxe

BOOL DrvUpgradePrinter(
                 DWORD  Level,
  [in, optional] LPBYTE pDriverUpgradeInfo
);

Parâmetros

Level

Valor fornecido pelo chamador que indica o tipo de estrutura apontada por pDriverUpgradeInfo, conforme indicado na tabela a seguir.

Valor de nível Estrutura apontada por pDriverUpgradeInfo
1 DRIVER_UPGRADE_INFO_1
2 DRIVER_UPGRADE_INFO_2

[in, optional] pDriverUpgradeInfo

Ponteiro fornecido pelo chamador para uma estrutura cujo tipo é identificado por dwLevel.

Retornar valor

Se a operação for bem-sucedida, a função deverá retornar TRUE; caso contrário, ele deve chamar SetLastError para definir um código de erro e retornar FALSE.

Comentários

Opcionalmente, uma DLL de interface de impressora pode fornecer uma função DrvUpgradePrinter . Se isso acontecer, o spooler o chamará para cada impressora quando o driver da impressora for copiado para o sistema. Isso ocorre quando um sistema é atualizado de uma versão do sistema operacional para a próxima ou quando um aplicativo atualiza um driver de impressora chamando a função Win32 AddPrinterDriver .

Geralmente, uma nova versão do driver requer configurações do Registro diferentes daquelas da versão antiga. A finalidade da função DrvUpgradePrinter é atualizar o registro para que ele seja compatível com o driver. Para obter mais informações sobre como armazenar informações da impressora no registro, consulte DrvPrinterEvent.

Para o Windows 2000 e posterior, quando o spooler chama DrvUpgradePrinter, ele fornece um ponteiro de estrutura DRIVER_UPGRADE_INFO_2 para pDriverUpgradeInfo. Se a função retornar FALSE, o spooler chamará a função novamente, desta vez especificando um ponteiro de estrutura DRIVER_UPGRADE_INFO_1. Se essa chamada retornar FALSE, o spooler gravará uma entrada no log de eventos.

Para Windows NT 4.0 e anteriores, quando o spooler chama DrvUpgradePrinter, ele fornece um ponteiro de estrutura DRIVER_UPGRADE_INFO_1 para pDriverUpgradeInfo. Se a função retornar FALSE, o spooler gravará uma entrada no log de eventos.

Requisitos

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

Confira também

DRIVER_UPGRADE_INFO_1

DRIVER_UPGRADE_INFO_2

DrvPrinterEvent