IPrintCoreHelperUni::WhyConstrained 方法 (prcomoem.h)
IPrintCoreHelperUni::WhyConstrained
方法會提供一份選項清單,以限制目前組態中的指定功能選項組。
語法
HRESULT WhyConstrained(
[in, optional] const DEVMODE *pDevmode,
[in] DWORD cbSize,
[in] PCSTR pszFeatureKeyword,
[in] PCSTR pszOptionKeyword,
[out] const PRINT_FEATURE_OPTION **ppFOConstraints,
[out] DWORD *pdwNumOptions
);
參數
[in, optional] pDevmode
DEVMODEW 結構的指標。 如果提供此指標,IPrintCoreHelperUni::WhyConstrained
應該使用 pDevmode 所指向的 DEVMODEW 結構,而不是預設或目前的 DEVMODEW 結構。 如果這個方法是從外掛程式提供者呼叫,或從 IPrintOemUni::D evMode呼叫 ,則需要此參數。 在其他大部分情況下,參數應該 NULL。 當核心驅動程式將 pDevmode 設定為 NULL時,它會修改其內部狀態,而不是傳入的 DEVMODEW 結構。 這在完整UI取代等作業期間是必要的,其中 DDI 傳回的DEVMODEW結構,例如 DrvDocumentPropertySheets,是由核心驅動程式的UI模組提供服務。
[in] cbSize
pDevmode 參數所指向之 DEVMODEW 結構的大小,以位元組為單位。
[in] pszFeatureKeyword
包含功能名稱的 ANSI 字串指標。 功能名稱應該對應至 GPD 檔案中使用的關鍵詞。
[in] pszOptionKeyword
包含選項名稱的 ANSI 字串指標。 選項名稱應該對應至 GPD 檔案中使用的關鍵詞。
[out] ppFOConstraints
PRINT_FEATURE_OPTION 項目的陣列指標。 當 IPrintCoreHelperUni::WhyConstrained
傳回時,數位會包含一份功能專案組的清單,這些選項會限制在 pszOptionKeyword 參數中指定的選項。
[out] pdwNumOptions
變數的指標,這個變數會接收 ppFOConstraints 參數所指向之陣列中的功能選項組數目。
傳回值
IPrintCoreHelperUni::WhyConstrained
應該傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
作業成功。 |
|
一或多個自變數無效,或不支援此功能。 |
|
無法配置結果陣列的記憶體。 |
對於其他失敗,方法應該會傳回標準 COM 錯誤碼。
言論
如果指定的功能選項組不受限制,IPrintCoreHelperUni::WhyConstrained
會傳回S_OK,但會傳回 *pdwFOPairs 設定為 0,且將 *ppFOConstraints[0] 設定為 NULL。
請注意,這個方法的結果可能不會包含影響目前選取選項的所有選項。 不過,如果有無效的組合列出兩個以上的功能選項組,則清單中只會包含一個選項。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | prcomoem.h (include Prcomoem.h) |