Metodo IPrintSchemaTicket::GetFeature (printerextension.h)

Articolo
02/29/2024

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 valore dell'attributo name dell'elemento della funzionalità. 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 valore dell'attributo name 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, questo deve essere l'URI dello spazio dei nomi privato che definisce la funzionalità.

[out, retval] ppFeature

Caratteristica restituita.

Valore restituito

Questo metodo restituisce un valore HRESULT .

Commenti

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.