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) |