IPrintSchemaTicket::GetFeatureByKeyName-Methode (printerextension.h)

Artikel
03/05/2024

Ruft ein Feature aus dem PrintTicket basierend auf dem angegebenen Schlüsselnamen ab.

Syntax

HRESULT GetFeatureByKeyName(
  [in]          BSTR                bstrKeyName,
  [out, retval] IPrintSchemaFeature **ppFeature
);

Parameter

[in] bstrKeyName

Der Schlüsselname des Features.

[out, retval] ppFeature

Das zurückgegebene Feature.

Rückgabewert

Diese Methode gibt einen HRESULT-Wert zurück.

Hinweise

Unter IPrintSchemaCapabilities::GetFeatureByKeyName finden Sie die erkannten Featureschlüsselnamen, die äquivalenten öffentlichen Funktionsnamen des Schlüsselschemas und die unterstützten spezialisierten Optionstypen.

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.