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

Article
02/29/2024

Obtient une fonctionnalité nommée à partir de PrintTicket, 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

Nom de base de la valeur d’attribut name de l’élément de fonctionnalité. Par exemple, pour la fonctionnalité <Print Schema psf :Feature name="psk :JobOutputBin »>, le nom de base de la fonctionnalité est « JobOutputBin ».

[in] bstrNamespaceUri

URI de l’espace de noms de la valeur d’attribut name de l’élément de fonctionnalité. Par exemple, l’URI de l’espace de noms de la fonctionnalité de schéma d’impression publique « JobOutputBin » 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é définissant 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.