estrutura DRIVER_UPGRADE_INFO_2 (winddiui.h)

A estrutura DRIVER_UPGRADE_INFO_2 é usada como uma entrada para a função DrvUpgradePrinter de uma interface de impressora.

Sintaxe

typedef struct _DRIVER_UPGRADE_INFO_2 {
  LPTSTR pPrinterName;
  LPTSTR pOldDriverDirectory;
  DWORD  cVersion;
  LPTSTR pName;
  LPTSTR pEnvironment;
  LPTSTR pDriverPath;
  LPTSTR pDataFile;
  LPTSTR pConfigFile;
  LPTSTR pHelpFile;
  LPTSTR pDependentFiles;
  LPTSTR pMonitorName;
  LPTSTR pDefaultDataType;
  LPTSTR pszzPreviousNames;
} DRIVER_UPGRADE_INFO_2, *PDRIVER_UPGRADE_INFO_2;

Membros

pPrinterName

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o nome da impressora. Para obter mais informações, consulte a seção Comentários.

pOldDriverDirectory

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o diretório local no qual os arquivos antigos do driver de impressora podem ser encontrados.

cVersion

Especifica a versão do sistema operacional para a qual o driver foi gravado.

Valor	Sistema operacional
0	Windows 95/98/Me
1	Windows NT 3.1 a Windows NT 3.51
2	Windows NT 4.0
3	Windows 2000 e posterior

pName

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o nome do driver (por exemplo, "QMS 810"). Para obter mais informações, consulte a seção Comentários.

pEnvironment

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o ambiente para o qual o driver foi gravado (por exemplo, "Windows NT x86" ou "Windows Itanium").

pDriverPath

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica um nome de arquivo ou um caminho completo e um nome de arquivo para o arquivo que contém o driver do dispositivo (por exemplo, "pscript.dll").

pDataFile

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica um nome de arquivo ou um caminho completo e um nome de arquivo para o arquivo que contém dados do driver (por exemplo, "qms810.ppd").

pConfigFile

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica um nome de arquivo ou um caminho completo e um nome de arquivo para a biblioteca de vínculo dinâmico de configuração do driver de dispositivo (por exemplo, "pscrptui.dll").

pHelpFile

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica um nome de arquivo ou um caminho completo e um nome de arquivo para o arquivo de ajuda do driver do dispositivo.

pDependentFiles

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica os arquivos dos quais o driver depende. Cada nome de arquivo na cadeia de caracteres também é encerrado com um caractere nulo (por exemplo, "pscript.dll\0qms810.ppd\0pscrptui.dll\0pscrptui.hlp\0pstest.txt\0\0").

pMonitorName

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica um monitor de idioma (por exemplo, "Monitor PJL"). Esse membro pode ser NULL e deve ser especificado como não NULL somente para impressoras capazes de comunicação bidirecional.

pDefaultDataType

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o tipo de dados padrão do trabalho de impressão (por exemplo, "EMF").

pszzPreviousNames

Ponteiro para uma cadeia de caracteres terminada em NULL que especifica quaisquer nomes de driver de impressora anteriores compatíveis com esse driver (por exemplo, "OldName1\0OldName2\0\0").

Comentários

Quando DrvUpgradePrinter é chamado com seu parâmetro pDriverUpgradeInfo apontando para uma estrutura DRIVER_UPGRADE_INFO_2, o membro pPrinterName aponta para uma cadeia de caracteres que contém o nome da impressora a ser atualizada. O membro pName aponta para uma cadeia de caracteres que contém o nome do driver da impressora a ser atualizado, que não é necessariamente o driver da impressora cujo nome é apontado pelo membro pPrinterName .

Para ver como isso pode ocorrer, suponha que um computador esteja conectado a duas impressoras, uma cujo driver é chamado de "Plotador acme" e o outro cujo driver é chamado de "Acme RasterMaster". Suponha também que ambos os drivers compartilhem um arquivo de driver comum, plotui.dll. Quando o driver "Plotador acme" é atualizado por uma chamada para a função AddPrinterDriverEx (descrita na documentação do SDK do Microsoft Windows), DrvUpgradePrinter é chamado para ambas as impressoras, pois ambos os drivers usam arquivos afetados pela atualização. Em ambas as chamadas, o membro pName aponta para "Plotador acme", o nome do driver de impressora usado na chamada para AddPrinterDriverEx. No entanto, a cadeia de caracteres apontada pelo membro pPrinterName é diferente em ambas as chamadas para DrvUpgradePrinter. Em cada chamada, pPrinterName aponta para o nome da impressora que está sendo atualizada.

Requisitos

Requisito	Valor
Cabeçalho	winddiui.h (inclua Winddiui.h)

Confira também

DRIVER_UPGRADE_INFO_1

DrvUpgradePrinter