共用方式為

IPrintCoreHelperUni：：GetOption 方法 （prcomoem.h）

  • 發行項

IPrintCoreHelperUni::GetOption 方法會取得指定特徵的指定選項。

語法

HRESULT GetOption(
  [in, optional] const DEVMODE *pDevmode,
  [in]           DWORD         cbSize,
  [in]           PCSTR         pszFeatureRequested,
  [out]          PCSTR         *ppszOption
);

參數

[in, optional] pDevmode

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

[in] cbSize

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

[in] pszFeatureRequested

ANSI 字串的指標，其中包含 GPD 檔案中顯示的功能名稱。

[out] ppszOption

包含 ANSI 字串位址之變數的指標。 傳回 IPrintCoreHelperUni::GetOption 時，字串應該包含目前選取選項的 關鍵詞，因為它出現在組態檔中。 呼叫端不應該修改此字串，而且不應該釋放與此字串相關聯的記憶體。

傳回值

IPrintCoreHelperUni::GetOption 應該傳回下列其中一個值。

傳回碼 描述
S_OK
 方法會讀取指定之功能的選項。
E_FAIL
 呼叫端提供了導致無效要求的資訊。 例如，所要求的功能不存在。
E_INVALIDARG
 自變數無效。 此值可能表示不支援此功能，或要求太多選項的功能。
E_OUTOFMEMORY
 核心驅動程式無法服務要求，因為記憶體不足。
E_UNEXPECTED 或其他未列於此處的傳回碼
 核心驅動程式似乎處於無效狀態。 呼叫端應該傳回失敗碼。

言論

IPrintCoreHelperUni::GetOption 不能用於允許同時設定多個選項的功能。

功能關鍵詞如 GPD 檔案中所定義。 此外，Unidrv 驅動程式針對儲存在其私人 DEVMODEW 結構中的選項，支持數個保留關鍵詞。 如需 Unidrv 功能清單，請參閱 關鍵詞對應。

呼叫端不應釋放由 ppszOption 所指向的字串，而且不應該以任何方式修改字串。

要求

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

另請參閱

IPrintCoreHelperUni

IPrintCoreHelperUni：：SetOptions