Condividi tramite


Metodo IPrintSchemaCapabilities::GetFeatureByKeyName (printerextension.h)

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.

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Piattaforma di destinazione Desktop
Intestazione printerextension.h

Vedi anche

IPrintSchemaCapabilities

IPrintSchemaNUpOption

IPrintSchemaOption

IPrintSchemaPageMediaSizeOption