Metodo IPrintOemUI::UpgradePrinter (prcomoem.h)

Il IPrintOemUI::UpgradePrinter metodo 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 completata.
E_FAIL
Operazione non riuscita.
E_NOTIMPL
Il metodo non è implementato.

Commenti

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

Il metodo del plug-in di IPrintOemUI::UpgradePrinter 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 IPrintOemUI::UpgradePrinter metodo .

Se IPrintOemUI::UpgradePrinter i 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 microsoft.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione prcomoem.h (include Prcomoem.h)