wiasGetContextFromName, fonction (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 de retour
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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamdef.h (include Wiamdef.h) |
| bibliothèque | Wiaservc.lib |
| DLL | Wiaservc.dll |