共用方式為


IPrintTicketProvider::GetSupportedVersions 方法 (prdrvcom.h)

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

語法

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

參數

[in] hPrinter

列印裝置的句柄。

[out] ppVersions

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

[out] cVersions

變數的指標,可接收 ppVersions所指向之陣列中的項目數目。

傳回值

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

備註

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

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

因為可以在呼叫 IPrintTicketProvider::BindPrinter 方法之前呼叫 IPrintTicketProvider::GetSupportedVersions,所以 OEM 外掛程式提供者必須根據 hPrinter 參數中傳遞的句柄來檢查版本支援。 因此,OEM 外掛程式提供者不應該關閉與 hPrinter 相關聯的印表機句柄。

規格需求

需求
標頭 prdrvcom.h (包含 Prdrvcom.h)

另請參閱

IPrintTicketProvider

IPrintTicketProvider::BindPrinter