IPrintCoreUI2::SetOptions メソッド (prcomoem.h)
IPrintCoreUI2::SetOptions
メソッドは、ドライバーの機能設定を設定します。
HRESULT SetOptions(
[in] POEMUIOBJ poemuiobj,
[in] DWORD dwFlags,
[in] PCZZSTR pmszFeatureOptionBuf,
[in] DWORD cbIn,
[out] PDWORD pdwResult
);
[in] poemuiobj
現在のコンテキストへのポインター。OEMUIOBJ 構造体。
[in] dwFlags
コア ドライバーが競合を解決するかどうかを指定します。 このパラメーターは、次のいずれかの値に設定する必要があります。
価値 | 意味 |
---|---|
SETOPTIONS_FLAG_KEEP_CONFLICT | 発生した競合を解決しないようにコア ドライバーに依頼します。 |
SETOPTIONS_FLAG_RESOLVE_CONFLICT | 発生した競合を解決するようにコア ドライバーに依頼します。 |
[in] pmszFeatureOptionBuf
MULTI_SZ形式の機能とオプションのキーワード ペアの一覧を含む呼び出し元が指定したバッファーへのポインター。 このリスト内の各項目は、次の項目から null 文字で区切られ、リストは 2 つの null 文字で終了します。
[in] cbIn
pmszFeatureOptionBuf 指すバッファーのサイズをバイト単位で指定します。 このサイズには、最後のMULTI_SZ null 文字が含まれます。
[out] pdwResult
次のいずれかの値を受け取るメモリ位置へのポインター。 これらの定数は printoem.h で定義されています。
価値 | 意味 |
---|---|
SETOPTIONS_RESULT_CONFLICT_REMAINED | コア ドライバーで競合が見つかりましたが、未解決のままです。 |
SETOPTIONS_RESULT_CONFLICT_RESOLVED | コア ドライバーが検出され、すべての競合が解決されました。 |
SETOPTIONS_RESULT_NO_CONFLICT | コア ドライバーで競合が見つかりませんでした。 |
このメソッドは、次のいずれかの値を返す必要があります。
リターン コード | 形容 |
---|---|
|
メソッドは成功しました。 |
|
このメソッドはサポートされていません。
dwLevel で指定 型の構造体はサポートされていません。 |
|
dwFlags の値が正しくありません。
入力バッファー (pmszFeatureOptionBuf が指す) がMULTI_SZ形式ではありません。 の パラメーターが無効なコンテキスト オブジェクトを指しています。 |
|
メソッドが失敗しました |
このメソッドは、Windows XP Pscript5 プラグインでのみサポートされ、Unidrv プラグインではサポートされません。
このメソッドは、機能/オプション のキーワード ペアの一覧を使用してドライバーの機能設定を設定するために呼び出されます。 呼び出し元は、IPrintCoreUI2::GetOptions メソッドを使用して、結果の機能設定にアクセスできます。
このメソッドが S_OK 以外の値を返す場合、ドライバーの機能設定に変更を加えませんでした。
pmszFeatureOptionBuf 入力バッファーは、IPrintCoreUI2::GetOptions メソッドの出力バッファーと同じ方法で構築する必要があります。 つまり、機能とオプションのキーワードペアはMULTI_SZ形式である必要があり、リスト内の各項目は null 文字で次の項目から区切られます。 null 文字のペアがリストを終了します。
入力バッファーに認識されない機能キーワードまたはそのオプション キーワードが含まれている場合、または現在の固定モードで機能が認識されているがサポートされていない場合 (プロパティ シート ページの置換 Driver-Suppliedを参照)、機能とオプションのペアは無視され、その機能の現在のオプションは引き続き有効になります。
このメソッドは、コア ドライバーの標準 UI ページを完全に置き換える UI プラグインでのみサポートされ、UI プラグインの IPrintOemUI::D ocumentPropertySheets および IPrintOemUI::D evicePropertySheets 関数とそのプロパティ シート コールバック ルーチンの間にのみサポートされます。
詳細については、「GetOptions と SetOptions の使用」を参照してください。
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | prcomoem.h (Prcomoem.h を含む) |
IPrintOemUI::D evicePropertySheets
IPrintOemUI::D ocumentPropertySheets
OEMUIOBJ を する