Metodo IPrintCoreHelperPS::EnumConstrainedOptions (prcomoem.h)
Il metodo IPrintCoreHelperPS::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, IPrintCoreHelperPS::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, 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 IPrintCoreHelperPS::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
IPrintCoreHelperPS::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) |