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

El IPrintOemUI::UpgradePrinter método 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 de 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 está implementado.

Comentarios

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 del dispositivo en el Registro, debe implementar el IPrintOemUI::UpgradePrinter método para actualizar esos valores.

Un método del complemento de interfaz de IPrintOemUI::UpgradePrinter usuario realiza los mismos tipos de operaciones que la función 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 IPrintOemUI::UpgradePrinter método .

Si IPrintOemUI::UpgradePrinter varios complementos de interfaz de usuario exportan 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	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)