IPrintSchemaCapabilities::GetFeature-Methode (printerextension.h)
Ruft ein benanntes Feature aus der PrintCapabilities-Eigenschaft anhand des Namens und vollständigen Namespace-URI ab.
Syntax
HRESULT GetFeature(
[in] BSTR bstrName,
[in] BSTR bstrNamespaceUri,
[out, retval] IPrintSchemaFeature **ppFeature
);
Parameter
[in] bstrName
Der Basiswert des Attributs "name" des Feature-Elements. Für das Feature "Druckschema" sieht das Tag z. B. wie folgt <psf:Feature name="psk:JobOutputBin">aus und zeigt einen Basiswert von "JobOutputBin".
[in] bstrNamespaceUri
Der Namespace-URI-Wert des Attributs "name" des Featureelements. Für das Feature "Druckschema" sieht das Tag z. B. wie folgt aus <psf:Featurename="psk:JobOutputBin">, mit einem Basisnamenwert von "JobOutputBin", und der Namespace-URI des öffentlichen Druckschemas lautet "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords". Wenn das Feature nicht im öffentlichen Druckschema definiert ist, sollte dies der URI des privaten Namespaces sein, der das Feature definiert.
[out, retval] ppFeature
Das zurückgegebene Feature.
Rückgabewert
Diese Methode gibt einen HRESULT- Wert zurück.
Bemerkungen
Wenn die angeforderte Funktion, Option oder Eigenschaft nicht gefunden wird, gibt diese Methode S_FALSE zurück und legt einen NULL-Zeiger für das Ausgabeobjekt des Features, der Option oder Eigenschaft fest.
Wenn das IPrintSchemaTicket-Objekt also nicht das angegebene Feature, die angegebene Option oder Eigenschaft enthält, muss die App ein IPrintSchemaCapabilities-Objekt abrufen und es über IPrintSchemaCapabilities::GetFeatureByKeyName oder über IPrintSchemaCapabilities::GetFeatureabfragen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| Zielplattform- | Desktop |
| Header- | printerextension.h |