IPrintCoreUI2::SetOptions-Methode (prcomoem.h)

Artikel
02/07/2025

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
S_OK	Die Methode war erfolgreich.
E_NOTIMPL	Die Methode wird nicht unterstützt. Eine Struktur des durch dwLevel- angegebenen Typs wird nicht unterstützt.
E_INVALIDARG	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.
E_FAIL	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.