Structure de variante

La plupart des fonctions de Active Accessibility Microsoft et les propriétés et méthodes IAccessible prennent une structure de variante comme paramètre. Fondamentalement, 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 qui sont 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 _ lVal
_distribution vt pdispVal
VT _ BSTR bstrVal
VT _ vide Aucun

Lorsque vous recevez des informations dans une structure de variante , vérifiez 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 d’Union qui contient les informations.

Avant d’utiliser la structure, initialisez-la en appelant la fonction COM (Component Object Model) VariantInit . Lorsque vous avez terminé avec la structure, effacez-la avant de libérer la mémoire qui contient la variante en appelant VariantClear.