Metodo IPrintCoreHelperUni::WhyConstrained (prcomoem.h)

Articolo
03/14/2023

Il IPrintCoreHelperUni::WhyConstrained metodo fornisce un elenco di opzioni che limitano la coppia di opzioni di funzionalità specificata nella configurazione corrente.

Sintassi

HRESULT WhyConstrained(
  [in, optional] const DEVMODE              *pDevmode,
  [in]           DWORD                      cbSize,
  [in]           PCSTR                      pszFeatureKeyword,
  [in]           PCSTR                      pszOptionKeyword,
  [out]          const PRINT_FEATURE_OPTION **ppFOConstraints,
  [out]          DWORD                      *pdwNumOptions
);

Parametri

[in, optional] pDevmode

Puntatore a una struttura DEVMODEW . Se viene fornito questo puntatore, IPrintCoreHelperUni::WhyConstrained usare la struttura DEVMODEW a cui punta pDevmode anziché la struttura DEVMODEW predefinita o corrente. Se questo metodo viene chiamato dal provider plug-in o da IPrintOemUni::D evMode, questo parametro è obbligatorio. Nella maggior parte delle altre situazioni, il parametro deve essere NULL. Quando il driver di base imposta pDevmode su NULL, modifica lo stato interno anziché quello della struttura DEVMODEW passata. Questa operazione è necessaria durante operazioni come la sostituzione completa dell'interfaccia utente, in cui la struttura DEVMODEW restituita da un DDI, ad esempio DrvDocumentPropertySheets, viene eseguita dal modulo dell'interfaccia utente del driver principale.

[in] cbSize

Dimensioni, in byte, della struttura DEVMODEW a cui punta il parametro pDevmode .

[in] pszFeatureKeyword

Puntatore a una stringa ANSI contenente il nome della funzionalità. Il nome della funzionalità deve corrispondere alla parola chiave usata nel file GPD.

[in] pszOptionKeyword

Puntatore a una stringa ANSI contenente il nome dell'opzione. Il nome dell'opzione deve corrispondere alla parola chiave usata nel file GPD.

[out] ppFOConstraints

Puntatore a una matrice di elementi PRINT_FEATURE_OPTION . Quando IPrintCoreHelperUni::WhyConstrained restituisce, la matrice contiene un elenco di coppie di elementi di funzionalità delle opzioni che limitano le opzioni specificate nel parametro pszOptionKeyword .

[out] pdwNumOptions

Puntatore a una variabile che riceve il numero di coppie di opzioni di funzionalità nella matrice a cui punta il parametro ppFOConstraints .

Valore restituito

IPrintCoreHelperUni::WhyConstrained deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Uno o più argomenti non sono validi oppure la funzionalità non è supportata.
E_OUTOFMEMORY	Impossibile allocare la memoria per la matrice di risultati.

Per altri errori, il metodo deve restituire un codice di errore COM standard.

Commenti

Se la coppia di opzioni di funzionalità specificata non è vincolata, restituirà S_OK ma IPrintCoreHelperUni::WhyConstrained restituirà con *pdwFOPairs impostata su 0 e con *ppFOConstraints[0] impostata su NULL.

Si noti che i risultati di questo metodo potrebbero non contenere tutte le opzioni che influiscono sull'opzione attualmente selezionata. Se sono presenti combinazioni non valide che elencano più di due coppie di opzioni di funzionalità, tuttavia, solo un'opzione della combinazione verrà inclusa nell'elenco.

Requisiti

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

Vedi anche

IPrintCoreHelperUni

IPrintCoreHelperUni::EnumConstrainedOptions

Condividi tramite