Función DrvUpgradePrinter (winddiui.h)
Las función DrvUpgradePrinter de una interfaz de impresora se usan para actualizar la configuración del Registro de una impresora cuando se agrega una nueva versión del controlador a un sistema.
Sintaxis
BOOL DrvUpgradePrinter(
DWORD Level,
[in, optional] LPBYTE pDriverUpgradeInfo
);
Parámetros
Level
Valor proporcionado por el autor de la llamada que indica el tipo de estructura al que apunta pDriverUpgradeInfo, como se indica en la tabla siguiente.
| valor de nivel de | Estructura a la que apunta pDriverUpgradeInfo |
|---|---|
| 1 | DRIVER_UPGRADE_INFO_1 |
| 2 | DRIVER_UPGRADE_INFO_2 |
[in, optional] pDriverUpgradeInfo
Puntero proporcionado por el llamador a una estructura cuyo tipo se identifica mediante dwLevel.
Valor devuelto
Si la operación se realiza correctamente, la función debe devolver TRUE; De lo contrario, debe llamar a SetLastError para establecer un código de error y devolver FALSE.
Observaciones
Una dll de interfaz de impresora puede proporcionar opcionalmente una función DrvUpgradePrinter. Si es así, el colador lo llama para cada impresora cuando el controlador de impresora se copia en el sistema. Esto ocurre cuando se actualiza un sistema desde una versión del sistema operativo a la siguiente, o cuando una aplicación actualiza un controlador de impresora llamando a la función de Win32 AddPrinterDriver.
A menudo, una nueva versión del controlador requiere la configuración del Registro diferente de las de la versión anterior. El DrvUpgradePrinter función es actualizar el registro para que sea compatible con el controlador. Para obtener más información sobre cómo almacenar información de impresora en el Registro, consulte DrvPrinterEvent.
Para Windows 2000 y versiones posteriores, cuando el colador llama a drvUpgradePrinter, proporciona un puntero de estructura de DRIVER_UPGRADE_INFO_2 para pDriverUpgradeInfo. Si la función devuelve FALSE, el colador llama a la función de nuevo, esta vez especificando un puntero de estructura DRIVER_UPGRADE_INFO_1. Si esta llamada devuelve FALSE, el colador escribe una entrada en el registro de eventos.
Para Windows NT 4.0 y versiones anteriores, cuando el colador llama a drvUpgradePrinter, proporciona un puntero de estructura de DRIVER_UPGRADE_INFO_1 para pDriverUpgradeInfo. Si la función devuelve FALSE, el colador escribe una entrada en el registro de eventos.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | winddiui.h (incluya Winddiui.h) |