Méthode IPrintSchemaCapabilities ::GetFeature (printerextension.h)

  • Article

Obtient une fonctionnalité nommée à partir de PrintCapabilities, par nom et URI d’espace de noms complet.

Syntaxe

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

Paramètres

[in] bstrName

Valeur de base de l’attribut « name » de l’élément Feature. Par exemple, pour la fonctionnalité Imprimer le schéma, la balise ressemble à ceci <psf :Feature name="psk :JobOutputBin »>, montrant une valeur de base de « JobOutputBin ».

[in] bstrNamespaceUri

Valeur d’URI d’espace de noms de l’attribut « name » de l’élément Feature. Par exemple, pour la fonctionnalité Imprimer le schéma, la balise ressemble à ce <psf :Feature name="psk :JobOutputBin »>, avec une valeur de nom de base « JobOutputBin », et l’URI d’espace de noms du schéma d’impression public est « https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords". Si la fonctionnalité n’est pas définie dans le schéma d’impression public, il doit s’agir de l’URI de l’espace de noms privé qui définit la fonctionnalité.

[out, retval] ppFeature

Fonctionnalité retournée.

Valeur retournée

Cette méthode retourne une valeur HRESULT .

Remarques

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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Plateforme cible Desktop (Expérience utilisateur)
En-tête printerextension.h

Voir aussi

IPrintSchemaCapabilities

IPrintSchemaFeature

IPrintSchemaTicket