Metodo IPrintCoreHelper::EnumConstrainedOptions (prcomoem.h)

  • Articolo

Il metodo IPrintCoreHelper::EnumConstrainedOptions fornisce un elenco di tutte le opzioni vincolate in una determinata funzionalità, in base alle impostazioni correnti.

Sintassi

HRESULT EnumConstrainedOptions(
  [in, optional] IN const DEVMODE *pDevmode,
  [in]           IN DWORD         cbSize,
  [in]           IN PCSTR         pszFeatureKeyword,
  [out]          OUT PCSTR * []   pConstrainedOptionList,
  [out]          OUT DWORD        *pdwNumOptions
);

Parametri

[in, optional] pDevmode

Puntatore a una struttura DEVMODEW . Se viene fornito questo puntatore, IPrintCoreHelper::EnumConstrainedOptions deve 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 IPrintOemPS::D evMode o IPrintOemUni::D evMode o da un provider di ticket di stampa, 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

Stringa di caratteri ANSI che contengono il nome della funzionalità.

[out] pConstrainedOptionList

Puntatore a una matrice di stringhe di caratteri ANSI. Quando IPrintCoreHelper::EnumConstrainedOptions restituisce, queste stringhe contengono i nomi di tutte le opzioni vincolate all'interno della funzionalità specificata. Il chiamante non è responsabile della liberazione della matrice o delle singole stringhe nella matrice.

[out] pdwNumOptions

Puntatore a una variabile che riceve il numero di opzioni vincolate nella matrice a cui punta il parametro pConstrainedOptionList .

Valore restituito

IPrintCoreHelper::EnumConstrainedOptions deve restituire uno dei valori seguenti.

Codice restituito Descrizione
S_OK Le opzioni vincolate sono state impostate per la funzionalità specificata.
E_FAIL Il chiamante ha fornito informazioni che hanno generato una richiesta non valida, ad esempio una richiesta per una funzionalità che non esiste.
E_INVALIDARG Uno o più argomenti non sono validi. Questo valore potrebbe significare che la funzionalità non è supportata.
E_OUTOFMEMORY Memoria insufficiente per creare la matrice di opzioni o il driver di base non è riuscito a eseguire il servizio a causa della mancanza di memoria.
E_UNEXPECTED o altri errori non elencati in modo esplicito qui Si è verificata una condizione imprevista. Il driver di base è probabilmente in uno stato non valido. Il chiamante deve uscire con un codice di errore.

Requisiti

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

Vedi anche

IPrintCoreHelper

IPrintCoreHelper::EnumOptions

IPrintCoreHelper::WhyConstrained