IPrintSchemaCapabilities::GetFeature-Methode (printerextension.h)

  • Artikel

Ruft ein benanntes Feature anhand des Namens und des vollständigen Namespace-URI aus printCapabilities 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 die Funktion "Druckschema" sieht das Tag beispielsweise wie folgt <aus: psf:Feature name="psk:JobOutputBin"> und zeigt den Basiswert "JobOutputBin" an.

[in] bstrNamespaceUri

Der Namespace-URI-Wert des Attributs "name" des Feature-Elements. Für die Funktion "Druckschema" sieht das Tag beispielsweise wie folgt <aus: psf:Feature name="psk:JobOutputBin">, mit dem Basisnamenwert "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.

Hinweise

Wenn die angeforderte Funktion, Option oder Eigenschaft nicht gefunden wird, gibt diese Methode S_FALSE zurück und legt einen NULL-Zeiger auf das Ausgabeobjekt des Features, der Option oder der 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::GetFeature abfragen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Zielplattform Desktop
Kopfzeile printerextension.h

Weitere Informationen

IPrintSchemaCapabilities

IPrintSchemaFeature

IPrintSchemaTicket