Metodo IPrintOemUI::UpgradePrinter (prcomoem.h)

Il metodo IPrintOemUI::UpgradePrinter consente a un plug-in dell'interfaccia utente di aggiornare i valori delle opzioni del dispositivo archiviati nel Registro di sistema.

Sintassi

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

Parametri

dwLevel

Numero di versione fornito dal chiamante della struttura a cui punta pDriverUpgradeInfo. Il valore valido corrente è 1.

pDriverUpgradeInfo

Puntatore fornito dal chiamante a una struttura DRIVER_UPGRADE_INFO_1.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione riuscita.
E_FAIL	Operazione non riuscita.
E_NOTIMPL	Il metodo non è implementato.

Osservazioni

Se si fornisce un plug-in dell'interfaccia utente per uno dei driver della stampante di Microsoft e se il plug-in dell'interfaccia utente archivia i valori delle opzioni di dispositivo nel Registro di sistema, deve implementare il metodo IPrintOemUI::UpgradePrinter per aggiornare tali valori.

Il metodo di IPrintOemUI::UpgradePrinter di un'interfaccia utente esegue gli stessi tipi di operazioni della funzione DrvUpgradePrinter esportata dalle DLL dell'interfaccia della stampante in modalità utente. Quando viene chiamata la funzione DrvUpgradePrinter del driver, aggiorna i propri valori del Registro di sistema e quindi chiama il metodo IPrintOemUI::UpgradePrinter.

Se IPrintOemUI::UpgradePrinter metodi vengono esportati da più plug-in dell'interfaccia utente, i metodi vengono chiamati nell'ordine in cui vengono specificati i plug-in per l'installazione.

Per altre informazioni sulla creazione e l'installazione di plug-in dell'interfaccia utente, vedere Personalizzazione dei driver della stampante di Microsoft.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	prcomoem.h (include Prcomoem.h)