IPrintSchemaTicket::GetFeature-Methode (printerextension.h)

Artikel
02/27/2024

Ruft ein benanntes Feature aus dem PrintTicket ab, nach Name und vollständigem Namespace-URI.

Syntax

HRESULT GetFeature(
  [in]          BSTR                bstrName,
  [in]          BSTR                bstrNamespaceUri,
  [out, retval] IPrintSchemaFeature **ppFeature
);

Parameter

[in] bstrName

Der Basisname des Name-Attributwerts des Featureelements. Für das Print Schema Feature <psf:Feature name="psk:JobOutputBin"> lautet der Basisname des Features beispielsweise "JobOutputBin".

[in] bstrNamespaceUri

Der Namespace-URI des Name-Attributwerts des Featureelements. Beispielsweise ist der Namespace-URI des öffentlichen Druckschemafeatures "JobOutputBin" "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.