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 應該傳回下列其中一個值。

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

針對其他失敗，方法應該會傳回標準 COM 錯誤碼。

備註

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

請注意，此方法的結果可能不包含影響目前選取選項的所有選項。 不過，如果有無效的組合列出兩個以上的功能選項組，則清單中只會包含一個選項。

規格需求

需求 值
目標平台 桌面
標頭 prcomoem.h (包括 Prcomoem.h)

另請參閱

IPrintCoreHelperUni

IPrintCoreHelperUni：：EnumConstrainedOptions