Método IPrintOemUI::UpgradePrinter (prcomoem.h)

El método IPrintOemUI::UpgradePrinter permite que un complemento de interfaz de usuario actualice los valores de opción del dispositivo almacenados en el Registro.

Sintaxis

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

Parámetros

dwLevel

Número de versión proporcionado por el autor de la llamada de la estructura a la que apunta pDriverUpgradeInfo. El valor válido actual es 1.

pDriverUpgradeInfo

Puntero proporcionado por el autor de la llamada a una estructura DRIVER_UPGRADE_INFO_1.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación.
E_NOTIMPL	El método no se implementa.

Observaciones

Si proporciona un complemento de interfaz de usuario para uno de los controladores de impresora de Microsoft y, si el complemento de interfaz de usuario almacena los valores de opción de dispositivo en el Registro, debe implementar el método IPrintOemUI::UpgradePrinter para actualizar esos valores.

Un método IPrintOemUI::UpgradePrinter del complemento de interfaz de usuario realiza los mismos tipos de operaciones que la función de DrvUpgradePrinter que exporta los archivos DLL de la interfaz de impresora en modo de usuario. Cuando se llama a la función drvUpgradePrinter del controlador, actualiza sus propios valores del registro y, a continuación, llama al método IPrintOemUI::UpgradePrinter.

Si varios complementos de interfaz de usuario exportan IPrintOemUI::UpgradePrinter métodos, se llama a los métodos en el orden en que se especifican los complementos para la instalación.

Para obtener más información sobre cómo crear e instalar complementos de interfaz de usuario, vea Personalización de los controladores de impresora de Microsoft.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	prcomoem.h (include Prcomoem.h)