IPrintOemUni::P ublishDriverInterface-Methode (prcomoem.h)
Die IPrintOemUni::PublishDriverInterface Methode ermöglicht es einem Rendering-Plug-In für Unidrv, die IPrintOemDriverUni - oder IPrintCoreHelperUni-Schnittstelle des Unidrv-Treibers abzurufen.
Syntax
HRESULT PublishDriverInterface(
IUnknown *pIUnknown
);
Parameter
pIUnknown
Vom Aufrufer bereitgestellter Zeiger auf die IUnknown-Schnittstelle der IPrintOemDriverUni COM-Schnittstelle des Treibers oder auf die IPrintCoreHelperUni-Schnittstelle.
Rückgabewert
Die -Methode muss einen der folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. |
|
Fehler beim Vorgang. |
Hinweise
Ein Rendering-Plug-In für Unidrv muss die IPrintOemUni::PublishDriverInterface -Methode implementieren, und die -Methode muss S_OK als Antwort auf mindestens einen Aufruf zurückgeben. Andernfalls ruft der Treiber die anderen IPrintOemUni-Schnittstellenmethoden des Plug-Ins nicht auf.
Die Methode sollte Informationen zu den unterstützten Unidrv-Schnittstellen wie folgt zurückgeben:
-
Der Unidrv-Treiber ruft zuerst die
IPrintOemUI::PublishDriverInterface-Methode auf, wobei der pIUnknown-Zeiger auf die IUnknown-Schnittstelle von IPrintOemDriverUni instance festgelegt ist. Wenn das Rendering-Plug-In IPrintOemDriverUni-Schnittstellenmethoden aufruft, muss es den empfangenen IUnknown-Schnittstellenzeiger verwenden, um IUnknown::QueryInterface aufzurufen (in der Microsoft Windows SDK-Dokumentation beschrieben), um einen Zeiger auf die vom Treiber unterstützte Version der IPrintOemDriverUni-Schnittstelle abzurufen. Weitere Informationen finden Sie unter Schnittstellenbezeichner für Druckertreiber. -
Wenn die IPrintOemUni::GetInfo-Methode des Plug-Ins als Reaktion auf einen Aufruf mit dwMode auf OEMGI_GETREQUESTEDHELPERINTERFACES einen Wert von OEMPUBLISH_IPRINTCOREHELPER in pBuffer zurückgegeben hat, ruft der Unidrv-Treiber die
IPrintOemUni::PublishDriverInterfaceMethode erneut auf, wobei der pIUnknown-Zeiger jedoch auf ein Objekt festgelegt ist, das die Schnittstellen IPrintCoreHelperUni und IPrintCoreHelper implementiert. Wenn das Plug-In einen Zeiger auf das -Objekt beibehält, sollte die -Methode S_OK zurückgeben. Andernfalls sollte die Methode E_FAIL zurückgeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | prcomoem.h (einschließlich Prcomoem.h) |