VARIANT Structure
La plupart des fonctions Microsoft Active Accessibility et les propriétés et méthodes IAccessible prennent une structure VARIANT comme paramètre. Essentiellement, la structure VARIANT est un conteneur pour une grande union qui transporte de nombreux types de données.
La valeur du premier membre de la structure, vt, décrit les membres de l’union valides. Bien que la structure VARIANT prenne en charge de nombreux types de données différents, Microsoft Active Accessibility utilise uniquement les types suivants.
| Valeur vt | Nom du membre de valeur correspondant |
|---|---|
| VT_I4 | lVal |
| VT_DISPATCH | pdispVal |
| VT_BSTR | bstrVal |
| VT_EMPTY | Aucun |
Lorsque vous recevez des informations dans une structure VARIANT , consultez le membre vt pour savoir quel membre contient des données valides. De même, lorsque vous envoyez des informations à l’aide d’une structure VARIANT , définissez toujours vt pour refléter le membre de l’union qui contient les informations.
Avant d’utiliser la structure, initialisez-la en appelant la fonction COM (Component Object Model) VariantInit . Une fois la structure terminée, effacez-la avant que la mémoire qui contient le VARIANT soit libérée en appelant VariantClear.