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