Função DrvUpgradePrinter (winddiui.h)
A função DrvUpgradePrinter de uma interface de impressora é usada para atualizar as configurações de 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 apontado por pDriverUpgradeInfo, conforme indicado na tabela a seguir.
| valor de 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.
Valor de retorno
Se a operação for bem-sucedida, a função deverá retornar VERDADEIRO; caso contrário, ele deve chamar SetLastError para definir um código de erro e retornar false.
Observações
Uma de DLL da interface da impressora pode, opcionalmente, fornecer uma função DrvUpgradePrinter. Se isso acontecer, o spooler o chamará para todas as impressoras 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 das da versão antiga. O DrvUpgradePrinter finalidade da função é 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 o Windows NT 4.0 e anterior, 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winddiui.h (inclua Winddiui.h) |