Metodo IPrintCoreHelperUni::EnumConstrainedOptions (prcomoem.h)

Articolo
02/26/2024

Il metodo IPrintCoreHelperUni::EnumConstrainedOptions fornisce un elenco di tutte le opzioni vincolate in una particolare 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, IPrintCoreHelperUni::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 IPrintOemUni::D evMode, questo parametro è obbligatorio. Nella maggior parte delle altre situazioni, il parametro deve essere NULL. Quando il driver principale 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

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

[in] pszFeatureKeyword

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

[out] pConstrainedOptionList

Puntatore a una matrice di stringhe di caratteri ANSI. Quando restituisce IPrintCoreHelperUni::EnumConstrainedOptions , queste stringhe conterranno 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

IPrintCoreHelperUni::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 principale non è riuscito a gestire la richiesta a causa della mancanza di memoria.
E_UNEXPECTED o altri errori non elencati qui	Si è verificata una condizione imprevista. Il driver principale è 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

IPrintCoreHelperUni

IPrintCoreHelperUni::EnumOptions