IPrintOemUI::D evQueryPrintEx 方法 (prcomoem.h)
方法 IPrintOemUI::DevQueryPrintEx
可讓使用者介面外掛程式協助判斷列印作業是否可列印。
語法
HRESULT DevQueryPrintEx(
POEMUIOBJ poemuiobj,
PDEVQUERYPRINT_INFO pDQPInfo,
PDEVMODE pPublicDM,
PVOID pOEMDM
);
參數
poemuiobj
OEMUIOBJ 結構的呼叫端提供指標。
pDQPInfo
呼叫端提供的 DEVQUERYPRINT_INFO結構的指標 。
pPublicDM
呼叫端提供的指標,指向已驗證的 DEVMODEW 結構。
pOEMDM
呼叫端提供的指標,指向使用者介面外掛程式的私人 DEVMODEW 結構成員。
傳回值
方法必須傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
作業成功。 |
|
作業失敗。 |
|
此方法尚未實作。 |
備註
使用者介面外掛程式的 IPrintOemUI::DevQueryPrintEx
方法會執行與使用者模式印表機介面 DLL 所匯出之 DevQueryPrintEx 函式相同的作業類型。 您可以使用這個方法來增強 DevQueryPrintEx 函式所提供的功能。 如同 DevQueryPrintEx 函式, IPrintOemUI::DevQueryPrintEx
方法的責任是判斷是否可以列印所提供 DEVMODEW 結構所描述的列印作業。
呼叫驅動程式的 DevQueryPrintEx 函式時,它會檢查 DEVMODEW 結構,以及目前選取的印表機選項,以判斷作業是否可列印。 如果不是,函式會傳回 FALSE。 如果作業似乎可列印,函式會在與驅動程式相關聯的每個使用者介面外掛程式中呼叫 IPrintOemUI::DevQueryPrintEx
方法。 如果所有 IPrintOemUI::DevQueryPrintEx
方法都傳回S_OK, 則 DevQueryPrintEx 會傳回 TRUE。 因此,除非 DevQueryPrintEx 函式和所有 IPrintOemUI::DevQueryPrintEx
方法宣告為可列印,否則無法列印作業。
如果 IPrintOemUI::DevQueryPrintEx
方法是由多個使用者介面外掛程式匯出,則會依指定外掛程式安裝的順序呼叫方法。
如需建立及安裝使用者介面外掛程式的詳細資訊,請參閱 自定義 Microsoft 的印表機驅動程式。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | prcomoem.h (包括 Prcomoem.h) |