Metodo IPrintCoreUI2::SetOptions (prcomoem.h)

Articolo
02/26/2024

Il IPrintCoreUI2::SetOptions metodo imposta le impostazioni della 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, struttura OEMUIOBJ .

[in] dwFlags

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

Valore	Significato
SETOPTIONS_FLAG_KEEP_CONFLICT	Chiedere al driver core di non risolvere alcun conflitto che si verifica.
SETOPTIONS_FLAG_RESOLVE_CONFLICT	Chiedere al driver di base di risolvere eventuali conflitti che si verificano.

[in] pmszFeatureOptionBuf

Puntatore a un buffer fornito dal chiamante contenente un elenco di coppie di parole chiave di funzionalità/opzione in formato MULTI_SZ. Ogni elemento di questo elenco è separato dal successivo in base a 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 trovato 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 di base 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. Non è supportata una struttura del tipo specificato da dwLevel .
E_INVALIDARG	Il valore in dwFlags non è corretto. Il buffer di input (indicato da pmszFeatureOptionBuf) non era in formato MULTI_SZ. Il parametro poemuiobj punta a un oggetto contesto non valido.
E_FAIL	Il metodo non è riuscito

Commenti

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 di funzionalità/opzione. 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 buffer di input pmszFeatureOptionBuf deve essere costruito nello stesso modo del buffer di output del metodo IPrintCoreUI2::GetOptions . Vale a dire, le coppie di parole chiave di funzionalità/opzione devono essere in formato MULTI_SZ e ogni elemento nell'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 di funzionalità o la parola chiave dell'opzione non riconosciuta oppure la funzionalità viene riconosciuta ma non supportata nella modalità di blocco corrente (vedere Sostituzione di pagine foglio proprietà Driver-Supplied), la coppia di funzionalità/opzione viene ignorata e l'opzione corrente per tale funzionalità continua a essere effettiva.

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

Per altre informazioni, vedere Uso di GetOptions e SetOptions.