Metodo IPrintCoreUI2::SetOptions (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintCoreUI2::SetOptions imposta le impostazioni delle funzionalità del driver.

Sintassi

HRESULT SetOptions(
  [in]  POEMUIOBJ poemuiobj,
  [in]  DWORD     dwFlags,
  [in]  PCZZSTR   pmszFeatureOptionBuf,
  [in]  DWORD     cbIn,
  [out] PDWORD    pdwResult
);

Parametri

[in] poemuiobj

Puntatore al contesto corrente, una struttura OEMUIOBJ.

[in] dwFlags

Specifica se il driver principale deve risolvere i conflitti. Questo parametro deve essere impostato su uno dei valori seguenti:

Valore	Significato
SETOPTIONS_FLAG_KEEP_CONFLICT	Chiedere al driver principale di non risolvere eventuali conflitti che si verificano.
SETOPTIONS_FLAG_RESOLVE_CONFLICT	Chiedere al driver principale di risolvere eventuali conflitti che si verificano.

[in] pmszFeatureOptionBuf

Puntatore a un buffer fornito dal chiamante contenente un elenco di coppie di parole chiave feature/option nel formato MULTI_SZ. Ogni elemento di questo elenco è separato dal successivo da un carattere Null e l'elenco viene terminato con due caratteri Null.

[in] cbIn

Specifica le dimensioni, in byte, del buffer a cui punta pmszFeatureOptionBuf. Questa dimensione include l'ultimo carattere null MULTI_SZ.

[out] pdwResult

Puntatore a una posizione di memoria che riceve uno dei valori seguenti. Queste costanti sono definite in printoem.h.

Valore	Significato
SETOPTIONS_RESULT_CONFLICT_REMAINED	Il driver principale ha rilevato conflitti, ma li ha lasciati non risolti.
SETOPTIONS_RESULT_CONFLICT_RESOLVED	Il driver principale ha trovato e risolto tutti i conflitti.
SETOPTIONS_RESULT_NO_CONFLICT	Il driver principale non ha trovato alcun conflitto.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_NOTIMPL	Il metodo non è supportato. Una struttura del tipo specificato da dwLevel non è supportata.
E_INVALIDARG	Il valore in dwFlags non è corretto. Il buffer di input (a cui punta pmszFeatureOptionBuf) non era in formato MULTI_SZ. Il parametro poemuiobj punta a un oggetto contesto non valido.
E_FAIL	Il metodo non è riuscito

Osservazioni

Questo metodo è supportato solo per i plug-in Pscript5 di Windows XP, non per i plug-in Unidrv.

Questo metodo viene chiamato per impostare le impostazioni delle funzionalità del driver usando un elenco di coppie di parole chiave feature/option. Il chiamante può accedere alle impostazioni delle funzionalità risultanti usando il metodo IPrintCoreUI2::GetOptions.

Se questo metodo restituisce qualsiasi valore diverso da S_OK, non ha apportato alcuna modifica nelle impostazioni delle funzionalità del driver.

Il pmszFeatureOptionBuf buffer di input deve essere costruito nello stesso modo del buffer di output del metodo IPrintCoreUI2::GetOptions. Ovvero, le coppie di parole chiave feature/option devono essere in formato MULTI_SZ e ogni elemento dell'elenco è separato dal successivo in base a un carattere Null. Una coppia di caratteri Null termina l'elenco.

Se il buffer di input contiene una parola chiave della funzionalità o la relativa parola chiave di opzione non riconosciuta oppure la funzionalità viene riconosciuta ma non supportata nella modalità di sticky corrente (vedere Sostituzione di pagine della finestra delle proprietà Driver-Supplied), la coppia di funzionalità/opzione viene ignorata e l'opzione corrente per tale funzionalità continua a essere attiva.

Questo metodo è supportato solo per i plug-in dell'interfaccia utente che sostituiscono completamente le pagine dell'interfaccia utente standard del driver principale ed è supportato solo durante la IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicevicePropertySheets funzioni e le relative routine di callback del foglio delle proprietà.

Per altre informazioni, vedere Using GetOptions and SetOptions.