IPrintTicketProvider2::GetSupportedVersions-Methode (prdrvcom.h)
Die IPrintTicketProvider2::GetSupportedVersions- Methode ruft Die Hauptversionsnummern der Druckschemas ab, die vom Plug-In-Anbieter unterstützt werden.
Syntax
HRESULT GetSupportedVersions(
[in] IN HANDLE hPrinter,
[out] OUT INT * [] ppVersions,
[out] 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
IPrintTicketProvider2::GetSupportedVersions sollte S_OK zurückgeben, wenn der Vorgang erfolgreich ist. Wenn diese Methode aufgrund fehlender Arbeitsspeicher oder anderer Ressourcen fehlschlägt, sollte ein standardmäßiger COM-Fehlercode zurückgegeben werden.
Bemerkungen
IPrintTicketProvider2::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 in der Microsoft Windows SDK-Dokumentation beschriebenen CoTaskMemAlloc-Funktion zuweisen, das Plug-In ist jedoch nicht dafür verantwortlich, diesen Speicher freizugeben.
Da IPrintTicketProvider2::GetSupportedVersions- aufgerufen werden kann, bevor die IPrintTicketProvider2::BindPrinter-Methode aufgerufen wird, muss der OEM-Plug-In-Anbieter die Versionsunterstützung basierend auf dem Handle überprüfen, das im hPrinter Parameter übergeben wird. Daher sollte der OEM-Plug-In-Anbieter den Druckerhandle, der hPrinter-zugeordnet ist, nicht schließen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | prdrvcom.h (einschließlich Prdrvcom.h) |