共用方式為

IPrintCoreHelper：：WhyConstrained 方法 （prcomoem.h）

  • 發行項

IPrintCoreHelper：：WhyConstrained 方法提供一份選項清單，這些選項會限制目前組態中的指定功能選項組。

語法

HRESULT WhyConstrained(
  [in]  const DEVMODE              *pDevmode,
  [in]  DWORD                      cbSize,
  [in]  PCSTR                      pszFeatureKeyword,
  [in]  PCSTR                      pszOptionKeyword,
  [out] const PRINT_FEATURE_OPTION **ppFOConstraints,
  [out] DWORD                      *pdwNumOptions
);

參數

[in] pDevmode

DEVMODEW 結構的指標。 如果提供此指標，IPrintCoreHelper：：WhyConstrained 應該使用 pDevmode 所指向的 DEVMODEW 結構，而不是預設或目前的 DEVMODEW 結構。 如果這個方法是從外掛程式提供者呼叫，或是從 IPrintOemPS：:D evMode 或 IPrintOemUni：:D evMode呼叫，則需要此參數。 在其他大部分情況下，參數應該 NULL。 當核心驅動程式將 pDevmode 設定為 NULL時，它會修改其內部狀態，而不是傳入的 DEVMODEW 結構。 這在完整UI取代等作業期間是必要的，其中 DDI 傳回的DEVMODEW結構，例如 DrvDocumentPropertySheets，是由核心驅動程式的UI模組提供服務。

[in] cbSize

pDevmode 參數所指向之 DEVMODEW 結構的大小，以位元組為單位。

[in] pszFeatureKeyword

包含功能名稱的 ANSI 字串指標。 功能名稱應該對應至 GPD 或 PPD 檔案中使用的關鍵詞。

[in] pszOptionKeyword

包含選項名稱的 ANSI 字串指標。 選項名稱應該對應至 GPD 或 PPD 檔案中使用的關鍵詞。

[out] ppFOConstraints

PRINT_FEATURE_OPTION 項目的陣列指標。 當 IPrintCoreHelper：：WhyConstrained 傳回時，陣列會包含功能元素組的清單，這些選項會限制 pszOptionKeyword 參數中指定的選項。

[out] pdwNumOptions

變數的指標，這個變數會接收 ppFOConstraints 參數所指向之陣列中的功能選項組數目。

傳回值

IPrintCoreHelper：：WhyConstrained 應該傳回下列其中一個值。

傳回碼 描述
S_OK
 作業成功。
E_INVALIDARG
 一或多個自變數無效，或不支援此功能。
E_OUTOFMEMORY
 無法配置結果陣列的記憶體。

言論

如果指定的功能選項組不受限制，IPrintCoreHelper：：WhyConstrained 會傳回S_OK，但會傳回 *pdwFOPairs 設為 0，且將 *ppFOConstraints[0] 設定為 NULL。

請注意，這個方法的結果可能不會包含影響目前選取選項的所有選項。 針對 Unidrv 驅動程式，此列表會包含每個作用中條件約束集的至少一個選項。 不過，如果有無效的組合列出兩個以上的功能選項組，則清單中只會包含一個選項。

要求

要求 價值
目標平臺 桌面
標頭 prcomoem.h （include Prcomoem.h）

另請參閱

IPrintCoreHelper

IPrintCoreHelper：：EnumConstrainedOptions