Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IPrintCoreUI2::SetOptions-Methode legt die Featureeinstellungen des Treibers fest.
Syntax
HRESULT SetOptions(
[in] POEMUIOBJ poemuiobj,
[in] DWORD dwFlags,
[in] PCZZSTR pmszFeatureOptionBuf,
[in] DWORD cbIn,
[out] PDWORD pdwResult
);
Parameter
[in] poemuiobj
Zeigen Sie auf den aktuellen Kontext, eine OEMUIOBJ--Struktur.
[in] dwFlags
Gibt an, ob der Kerntreiber Konflikte lösen soll. Dieser Parameter muss auf einen der folgenden Werte festgelegt werden:
| Wert | Bedeutung |
|---|---|
| SETOPTIONS_FLAG_KEEP_CONFLICT | Bitten Sie den Kerntreiber, keinen Konflikt zu lösen, der entsteht. |
| SETOPTIONS_FLAG_RESOLVE_CONFLICT | Bitten Sie den Kerntreiber, einen Konflikt zu lösen, der entsteht. |
[in] pmszFeatureOptionBuf
Zeiger auf einen vom Aufrufer bereitgestellten Puffer, der eine Liste von Feature-/Options-Schlüsselwortpaaren im MULTI_SZ Format enthält. Jedes Element in dieser Liste wird vom nächsten durch ein Nullzeichen getrennt, und die Liste wird mit zwei Nullzeichen beendet.
[in] cbIn
Gibt die Größe des Puffers in Byte an, auf den pmszFeatureOptionBufverweist. Diese Größe enthält das letzte MULTI_SZ NULL-Zeichen.
[out] pdwResult
Zeigen Sie auf einen Speicherspeicherort, der einen der folgenden Werte empfängt. Diese Konstanten werden in printoem.h definiert.
| Wert | Bedeutung |
|---|---|
| SETOPTIONS_RESULT_CONFLICT_REMAINED | Der Kerntreiber hat Konflikte gefunden, aber sie wurden nicht aufgelöst. |
| SETOPTIONS_RESULT_CONFLICT_RESOLVED | Der Kerntreiber hat alle Konflikte gefunden und gelöst. |
| SETOPTIONS_RESULT_NO_CONFLICT | Der Kerntreiber hat keinen Konflikt gefunden. |
Rückgabewert
Die Methode muss einen der folgenden Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Methode war erfolgreich. |
|
Die Methode wird nicht unterstützt.
Eine Struktur des durch dwLevel- angegebenen Typs wird nicht unterstützt. |
|
Der Wert in dwFlags falsch.
Der Eingabepuffer (auf pmszFeatureOptionBuf) verweist, war nicht im MULTI_SZ Format. Der poemuiobj Parameter, der auf ein ungültiges Kontextobjekt verweist. |
|
Fehler bei der Methode. |
Bemerkungen
Diese Methode wird nur für Windows XP Pscript5-Plug-Ins unterstützt, nicht für Unidrv-Plug-Ins.
Diese Methode wird aufgerufen, um die Featureeinstellungen des Treibers mithilfe einer Liste von Feature-/Optionswortpaaren festzulegen. Der Aufrufer kann mithilfe der IPrintCoreUI2::GetOptions-Methode auf die resultierenden Featureeinstellungen zugreifen.
Wenn diese Methode einen anderen Wert als S_OK zurückgibt, hat sie in den Featureeinstellungen des Treibers keine Änderungen vorgenommen.
Der pmszFeatureOptionBuf Eingabepuffer muss auf die gleiche Weise wie der Ausgabepuffer der IPrintCoreUI2::GetOptions-Methode erstellt werden. Das heißt, die Schlüsselwortpaare "Feature/Option" müssen MULTI_SZ Format aufweisen, und jedes Element in der Liste wird vom nächsten durch ein NULL-Zeichen getrennt. Ein Nullzeichenpaar beendet die Liste.
Wenn der Eingabepuffer ein Feature-Schlüsselwort oder dessen Optionsschlüsselwort enthält, das nicht erkannt wird oder das Feature im aktuellen Haftmodus nicht unterstützt wird (siehe Ersetzen Driver-Supplied Eigenschaftenblattseiten), wird das Feature-/Optionspaar ignoriert, und die aktuelle Option für dieses Feature wird weiterhin wirksam.
Diese Methode wird nur für UI-Plug-Ins unterstützt, die die Standard-UI-Seiten des Haupttreibers vollständig ersetzen und nur während der IPrintOemUI::D ocumentPropertySheets und IPrintOemUI::D evicePropertySheets-Funktionen und deren Eigenschaftenblattrückrufroutinen unterstützt.
Weitere Informationen finden Sie unter Using GetOptions and SetOptions.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | prcomoem.h (einschließlich Prcomoem.h) |
Siehe auch
IPrintOemUI::D evicePropertySheets