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 mit Versionsnummern empfängt. Versionsnummern im Array können in beliebiger Reihenfolge angezeigt werden. Weitere Informationen zu diesem Parameter finden Sie im folgenden Abschnitt "Hinweise".
[out] cVersions
Ein Zeiger auf eine Variable, die die Anzahl der Elemente im Array empfängt, auf die von *ppVersionsverwiesen wird.
Rückgabewert
IPrintOemPrintTicketProvider::GetSupportedVersions sollte S_OK zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls sollte diese Methode einen standardmäßigen COM-Fehlercode zurückgeben.
Bemerkungen
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 Speicher mithilfe der CoTaskMemAlloc-Funktion zuordnen (in der Microsoft Windows SDK-Dokumentation beschrieben), ist jedoch nicht dafür verantwortlich, diesen Speicher freizugeben.
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 |
| Header- | prcomoem.h (einschließlich Prcomoem.h) |