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

Mit der IPrintOemUI::PublishDriverInterface-Methode kann ein Benutzeroberflächen-Plug-In das Unidrv- oder Pscript5-Treiber-IPrintOemDriverUI-, IPrintCoreUI2-, IPrintCoreHelperPSoder IPrintCoreHelperUni Schnittstelle abrufen.

Syntax

HRESULT PublishDriverInterface(
  IUnknown *pIUnknown
);

Parameter

pIUnknown

Vom Aufrufer bereitgestellter Zeiger auf die IUnknown Schnittstelle des Treibers IPrintCoreUI2 COM Interface, IPrintOemDriverUI COM Interface, IPrintCoreHelperPS Interfaceoder IPrintCoreHelperUni Interface. Siehe Anmerkungen.

Rückgabewert

Die Methode muss einen der folgenden Werte zurückgeben.

Bemerkungen

Der Pscript5-Treiber unterstützt die IPrintCoreUI2-, IPrintOemDriverUI-und IPrintCoreHelperPS Schnittstellen. Unidrv unterstützt die IPrintOemDriverUI- und IPrintCoreHelperUni Schnittstellen. Benutzeroberflächen-Plug-Ins für beide Treibertypen müssen die IPrintOemUI::PublishDriverInterface-Methode implementieren.

Die Methode sollte Informationen zu den unterstützten Pscript5-Schnittstellen wie folgt zurückgeben:

1. Der Pscript5-Treiber ruft zuerst die IPrintOemUI::PublishDriverInterface-Methode auf, wobei der pIUnknown Zeiger auf die IPrintCoreUI2-InstanzIUnknown--Schnittstelle festgelegt ist. Wenn das Benutzeroberflächen-Plug-In die IPrintCoreUI2- Schnittstelle verwenden kann, muss die Methode S_OK zurückgeben. Andernfalls sollte das Plug-In E_FAIL zurückgeben.
2. Wenn das Plug-In E_FAIL zurückgegeben hat, ruft der Pscript5-Treiber die IPrintOemUI::PublishDriverInterface Methode erneut auf, aber mit dem pIUnknown Zeiger auf die IPrintOemDriverUI Instanz IUnknown Schnittstelle festgelegt. Wenn das Plug-In die IPrintOemDriverUI Schnittstelle verwenden kann, muss die Methode S_OK zurückgeben. Andernfalls sollte das Plug-In E_FAIL zurückgeben.
3. Wenn die IPrintOemUI::GetInfo-Methode des Plug-Ins in pBuffer- als Reaktion auf einen Aufruf mit dwMode auf OEMGI_GETREQUESTEDHELPERINTERFACES festgelegt wurde, hat das Plug-In einen Wert OEMPUBLISH_IPRINTCOREHELPER zurückgegeben. Der Pscript5-Treiber ruft die IPrintOemUI::PublishDriverInterface Methode erneut auf, wobei jedoch der pIUnknown Zeiger auf ein Objekt festgelegt ist, das die IPrintCoreHelperPS und IPrintCoreHelper Schnittstellen implementiert. Wenn das Plug-In die IPrintCoreHelperPS oder IPrintCoreHelper Schnittstelle verwenden kann, sollte die Methode S_OK zurückgeben. Andernfalls sollte die Methode E_FAIL zurückgeben.

1. Der Unidrv-Treiber ruft zuerst die IPrintOemUI::PublishDriverInterface-Methode auf, wobei der pIUnknown Zeiger auf die IPrintOemDriverUI IUnknown--Schnittstelle der Instanz festgelegt ist. Wenn das Plug-In die IPrintOemDriverUI--Schnittstelle verwenden kann, muss die Methode S_OK zurückgeben. Andernfalls sollte das Plug-In E_FAIL zurückgeben.
2. Wenn die IPrintOemUI::GetInfo-Methode des Plug-Ins als Reaktion auf einen Aufruf mit dw Mode auf OEMGI_GETREQUESTEDHELPERINTERFACES pBuffer- einen Wert von OEMPUBLISH_IPRINTCOREHELPER zurückgegeben hat, Der Unidrv-Treiber ruft die IPrintOemUI::PublishDriverInterface-Methode erneut auf, aber mit dem pIUnknown Zeiger auf ein Objekt festgelegt, das die IPrintCoreHelperUni und IPrintCoreHelper Schnittstellen implementiert. Wenn das Plug-In die IPrintCoreHelperUni oder IPrintCoreHelper-Schnittstelle verwendet, sollte die Methode S_OK zurückgeben. Andernfalls sollte die Methode E_FAIL zurückgeben.

Während der Verarbeitung jeder DDI-Funktion, Ui-Plug-Ins sollten nicht die Verwendung von Methoden der Vor-Windows Vista-Schnittstellen (z. B. die IPrintOemDriverUI oder IPrintCoreUI2 Schnittstelle) und die neuen Methoden der Windows Vista-Schnittstellen (z. B. IPrintCoreHelperUni oder IPrintCoreHelperPS) zum Lesen oder Schreiben von Treibereinstellungen kombinieren. Beispielsweise sollte das UI-Plug-In während der IPrintOemUI::D ocumentPropertySheets Methode nicht die IPrintOemDriverUI::D rvUpdateUISetting-Methode verwenden, um Einstellungen zu schreiben und die IPrintCoreHelper::GetOption-Methode zum Lesen von Einstellungen zu verwenden. Ein weiteres Beispiel: Während der IPrintOemUI::P rinterEvent--Methode sollte das UI-Plug-In nicht die IPrintCoreUI2::GetOptions-Methode verwenden, um Einstellungen zu lesen und die IPrintCoreHelper::SetOptions Methode zum Schreiben von Einstellungen zu verwenden. Die Synchronisierung des Lesens und Schreibens von Einstellungen wird zwischen diesen verschiedenen Schnittstellenversionen nicht unterstützt.

Anforderungen

Siehe auch

IPrintOemUI-

IPrintOemUI::GetInfo