Metodo IPrintSchemaTicket::GetFeatureByKeyName (printerextension.h)

Articolo
02/26/2024

Ottiene una funzionalità da PrintTicket in base al nome della chiave specificato.

Sintassi

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

Parametri

[in] bstrKeyName

Nome della chiave della funzionalità.

[out, retval] ppFeature

Caratteristica restituita.

Valore restituito

Questo metodo restituisce un valore HRESULT .

Commenti

Vedere IPrintSchemaCapabilities::GetFeatureByKeyName per i nomi delle chiavi di funzionalità riconosciuti, i nomi delle funzionalità equivalenti dello schema di stampa pubblico e i tipi di opzione specializzati supportati.

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

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