IPrintOemUni::P ublishDriverInterface-Methode (prcomoem.h)

  • Artikel

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
S_OK
 Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL
 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:

  1. 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.
  2. 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::PublishDriverInterface Methode 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)

Weitere Informationen

IPrintOemUni

IPrintOemUni::GetInfo