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) |