VARIANT, structure
La plupart des fonctions Microsoft Active Accessibility et des propriétés et méthodes IAccessible prennent une structure VARIANT en tant que paramètre. Essentiellement, la structure VARIANT est un conteneur pour une grande union qui contient de nombreux types de données.
La valeur dans le 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 la valeur correspondante |
|---|---|
| VT_I4 | lVal |
| VT_DISPATCH | pdispVal |
| VT_BSTR | bstrVal |
| VT_EMPTY | aucun |
Lorsque vous recevez des informations dans une structure VARIANT, case activée le membre vt pour déterminer 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 ( VariantInit Component Object Model). Lorsque vous avez terminé avec la structure, effacez-la avant que la mémoire qui contient le VARIANT ne soit libérée en appelant VariantClear.