IPrintOemPrintTicketProvider::GetSupportedVersions-Methode (prcomoem.h)
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) |