Metodo IPrintCoreHelper::EnumConstrainedOptions (prcomoem.h)
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) |