IPrintOemPrintTicketProvider::GetSupportedVersions-Methode (prcomoem.h)

  • Artikel

Die IPrintOemPrintTicketProvider::GetSupportedVersions-Methode ruft Hauptversionen der Druckschemas ab, die vom Plug-In-Anbieter unterstützt werden.

Syntax

HRESULT GetSupportedVersions(
  [in]  HANDLE   hPrinter,
  [out] INT * [] ppVersions,
  [out] INT      *cVersions
);

Parameter

[in] hPrinter

Ein Handle für das Druckgerät.

[out] ppVersions

Ein Zeiger auf eine Variable, die die Adresse des ersten Elements eines Arrays von Versionsnummern empfängt. Versionsnummern im Array können in beliebiger Reihenfolge angezeigt werden. Weitere Informationen zu diesem Parameter finden Sie im abschnitt Hinweise.

[out] cVersions

Ein Zeiger auf eine Variable, die die Anzahl der Elemente im Array empfängt, auf die *ppVersions verweist.

Rückgabewert

IPrintOemPrintTicketProvider::GetSupportedVersions sollte S_OK zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls sollte diese Methode einen COM-Standardfehlercode zurückgeben.

Hinweise

IPrintOemPrintTicketProvider::GetSupportedVersions gibt die Hauptversionsnummern der Druckschemas zurück, die von der Anbieterschnittstelle unterstützt werden. (Die einzige aktuell definierte Versionsnummer ist 1.) Anbieter können Zwischenversionen weglassen.

Das Plug-In ist für die Zuordnung des Arrayspeichers verantwortlich, auf den der ppVersions-Parameter verweist. Das Plug-In sollte diesen Arbeitsspeicher mithilfe der CoTaskMemAlloc-Funktion zuordnen (die in der Microsoft Windows SDK-Dokumentation beschrieben wird), aber es ist nicht für die Freigabe dieses Arbeitsspeichers verantwortlich.

IPrintOemPrintTicketProvider::GetSupportedVersions kann aufgerufen werden, bevor die IPrintOemPrintTicketProvider::BindPrinter-Methode aufgerufen wird. Daher sollte der OEM-Plug-In-Anbieter den Druckerhandle, der dem hPrinter-Parameter zugeordnet ist, nicht schließen.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile prcomoem.h (einschließlich Prcomoem.h)

Weitere Informationen

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter