共用方式為


IPrintTicketProvider2::GetSupportedVersions 方法 (prdrvcom.h)

IPrintTicketProvider2::GetSupportedVersions 方法會擷取外掛程式提供者所支援的列印架構主要版本號碼。

語法

HRESULT GetSupportedVersions(
  [in]  IN HANDLE    hPrinter,
  [out] OUT INT * [] ppVersions,
  [out] OUT INT      *cVersions
);

參數

[in] hPrinter

列印裝置的句柄。

[out] ppVersions

變數的指標,可接收版本號碼陣列之第一個項目的位址。 陣列中的版本號碼可以依任何順序顯示。 如需此參數的詳細資訊,請參閱下列一節。

[out] cVersions

變數的指標,會接收 ppVersions 所指向之陣列中的元素數目,

傳回值

如果作業成功,IPrintTicketProvider2::GetSupportedVersions 應該傳回 S_OK。 如果此方法因為記憶體或其他資源不足而失敗,它應該會傳回標準 COM 錯誤碼。

言論

IPrintTicketProvider2::GetSupportedVersions 會傳回提供者介面所支援之列印架構的主要版本號碼。 目前唯一定義的版本號碼是 1。 提供者可以省略中繼版本。

外掛程式負責配置由 ppVersions 參數所指向的數位記憶體。 外掛程式應該使用 Microsoft Windows SDK 檔中所述的 CoTaskMemAlloc 函式來設定此記憶體,但外掛程式不負責釋放此記憶體。

由於呼叫 IPrintTicketProvider2::GetSupportedVersions,才能呼叫 IPrintTicketProvider2::BindPrinter 方法,OEM 外掛程式提供者必須根據傳入 hPrinter 參數的句柄來檢查版本支援。 因此,OEM 外掛程式提供者不應該關閉與 hPrinter 相關聯的印表機句柄。

要求

要求 價值
標頭 prdrvcom.h (包括 Prdrvcom.h)

另請參閱

IPrintTicketProvider2

IPrintTicketProvider2::BindPrinter