Metodo IPrintSchemaCapabilities::GetFeatureByKeyName (printerextension.h)

Articolo
08/07/2023

Ottiene una funzionalità da PrintCapabilities in base a un nome di chiave specificato.

Sintassi

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

Parametri

[in] bstrKeyName

Nome della chiave della funzionalità.

[out, retval] ppFeature

Funzionalità restituita.

Valore restituito

Questo metodo restituisce un valore HRESULT .

Commenti

Vengono riconosciuti solo i nomi delle chiavi delle funzionalità seguenti. I nomi delle chiavi sono equivalenti ai nomi delle funzionalità dello schema di stampa pubblici, come illustrato nella tabella seguente. La tabella mostra anche le funzionalità con tipi di opzione specializzati (per impostazione predefinita il tipo di opzione è IPrintSchemaOption).

Nome	Nome pubblico della funzionalità dello schema di stampa	Tipo di opzione specializzato
DocumentBinding	DocumentBinding o JobBindAllDocuments
DocumentCollate	DocumentCollate
DocumentDuplex	JobDuplexAllDocumentsContiguously
DocumentHolePunch	DocumentHolePunch o JobHolePunch
DocumentInputBin	JobInputBin, DocumentInputBin o PageInputBin
DocumentNUp	JobNUpAllDocumentsContiguously	IPrintSchemaNUpOption
DocumentStaple	JobStapleAllDocuments o DocumentStaple
Pagemediasize	Pagemediasize	IPrintSchemaPageMediaSizeOption
PageMediaType	PageMediaType
PageOrientation	PageOrientation
PageOutputColor	PageOutputColor
PageOutputQuality	PageOutputQuality

Quando la funzionalità richiesta, l'opzione o la proprietà non viene trovata, questo metodo restituisce S_FALSE e imposta un puntatore NULL sull'oggetto output della funzionalità, dell'opzione o della proprietà.

Quindi, se l'oggetto IPrintSchemaTicket non contiene la funzionalità, l'opzione o la proprietà specificati, l'app deve ottenere un oggetto IPrintSchemaCapabilities e eseguirne una query tramite IPrintSchemaCapabilities::GetFeatureByKeyName o tramite IPrintSchemaCapabilities::GetFeature.