IPrintSchemaCapabilities::GetFeatureByKeyName-Methode (printerextension.h)

Artikel
02/29/2024

Ruft ein Feature aus printCapabilities basierend auf einem 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

Nur die folgenden Featureschlüsselnamen werden erkannt. Die Schlüsselnamen entsprechen den Namen öffentlicher Druckschemafeatures, wie in der folgenden Tabelle gezeigt. Die Tabelle enthält auch die Features, die über spezielle Optionstypen verfügen (standardmäßig ist der Optionstyp IPrintSchemaOption).

Name	Öffentlicher Name des Schemafeatures drucken	Spezialisierter Optionstyp
DocumentBinding	DocumentBinding oder JobBindAllDocuments
DocumentCollate	DocumentCollate
DocumentDuplex	JobDuplexAllDocumentsContiguously
DocumentHolePunch	DocumentHolePunch oder JobHolePunch
DocumentInputBin	JobInputBin, DocumentInputBin oder PageInputBin
DocumentNUp	JobNUpAllDocumentsContiguously	IPrintSchemaNUpOption
DocumentStaple	JobStapleAllDocuments oder DocumentStaple
Pagemediasize	Pagemediasize	IPrintSchemaPageMediaSizeOption
Pagemediatype	Pagemediatype
PageOrientation	PageOrientation
PageOutputColor	PageOutputColor
PageOutputQuality	PageOutputQuality

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.