Méthode IPrintSchemaTicket ::GetFeatureByKeyName (printerextension.h)

Article
02/29/2024

Obtient une fonctionnalité du PrintTicket en fonction du nom de clé spécifié.

Syntaxe

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

Paramètres

[in] bstrKeyName

Nom de clé de la fonctionnalité.

[out, retval] ppFeature

Fonctionnalité retournée.

Valeur retournée

Cette méthode retourne une valeur HRESULT .

Remarques

Consultez IPrintSchemaCapabilities ::GetFeatureByKeyName pour connaître les noms de clés de fonctionnalité reconnus, les noms de caractéristiques de schéma d’impression publics équivalents aux noms de clés et les types d’options spécialisées pris en charge.

Lorsque la fonctionnalité, l’option ou la propriété demandée est introuvable, cette méthode retourne S_FALSE et définit un pointeur NULL sur l’objet de sortie de la fonctionnalité, de l’option ou de la propriété.

Par conséquent, si l’objet IPrintSchemaTicket ne contient pas la fonctionnalité, l’option ou la propriété spécifiée, l’application doit obtenir un objet IPrintSchemaCapabilities et l’interroger via IPrintSchemaCapabilities ::GetFeatureByKeyName ou via IPrintSchemaCapabilities ::GetFeature.