fonction wiasGetContextFromName (wiamdef.h)

La fonction wiasGetContextFromName récupère le contexte d’élément d’un nom d’élément.

Syntaxe

HRESULT wiasGetContextFromName(
  [in]  BYTE *pWiasContext,
        LONG lFlags,
  [in]  BSTR bstrName,
  [out] BYTE **ppWiasContext
);

Paramètres

[in] pWiasContext

Pointeur vers un contexte d’élément WIA.

lFlags

Réservé à l’utilisation du système et doit être défini sur 0.

[in] bstrName

Spécifie le nom du contexte recherché.

[out] ppWiasContext

Pointeur vers un emplacement de mémoire qui reçoit l’adresse du contexte d’élément WIA.

Valeur retournée

En cas de réussite, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une erreur COM standard ou l’un des codes d’erreur WIA.

Remarques

Cette fonction recherche les contextes d’élément dont la propriété WIA_IPA_FULL_ITEM_NAME correspond à bstrName. Notez que cette propriété est différente de WIA_IPA_ITEM_NAME, qui ne contient pas d’informations de chemin d’accès.

Cette fonction doit être utilisée par les minidrivers lorsqu’ils doivent passer d’un contexte d’élément d’application à un autre, en fonction du nom de l’élément. Les noms des éléments d’application proviennent de leurs éléments de pilote correspondants, que le minidriver crée et nomme.

Configuration requise

Voir aussi

wiasGetRootItem