Metodo IPrintSchemaTicket::GetFeature (printerextension.h)

Articolo
07/02/2025

Ottiene una funzionalità denominata dall'oggetto PrintTicket, in base al nome e all'URI completo dello spazio dei nomi.

Sintassi

HRESULT GetFeature(
  [in]          BSTR                bstrName,
  [in]          BSTR                bstrNamespaceUri,
  [out, retval] IPrintSchemaFeature **ppFeature
);

Parametri

[in] bstrName

Nome di base del nome valore dell'attributo dell'elemento feature. Ad esempio, per la funzionalità Schema di stampa <psf:Feature name="psk:JobOutputBin">, il nome di base della funzionalità è "JobOutputBin".

[in] bstrNamespaceUri

URI dello spazio dei nomi del nome valore dell'attributo dell'elemento feature. Ad esempio, l'URI dello spazio dei nomi della funzionalità pubblica schema di stampa "JobOutputBin" è "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords". Se la funzionalità non è definita nello schema di stampa pubblico, deve trattarsi dell'URI dello spazio dei nomi privato che definisce la funzionalità.

[out, retval] ppFeature

Funzionalità restituita.

Valore restituito

Questo metodo restituisce un valore HRESULT.

Osservazioni

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à specificata, l'app deve ottenere un oggetto IPrintSchemaCapabilities ed eseguirne una query tramite IPrintSchemaCapabilities::GetFeatureByKeyName o tramite IPrintSchemaCapabilities::GetFeature.