VARIANT-struktúra

A Microsoft Active Accessibility legtöbb függvénye, valamint az IAccessible tulajdonságai és metódusai paraméterként VARIANT struktúrát használnak. A VARIANT szerkezet lényegében egy olyan tároló, amely számos adattípust hordoz.

A struktúra első tagjának vtértéke azt írja le, hogy a szakszervezeti tagok közül melyik érvényes. Bár a VARIANT struktúra számos különböző adattípust támogat, a Microsoft Active Accessibility csak az alábbi típusokat használja.

vt érték	Megfelelő értéktag neve
VT_I4	lVal
VT_DISPATCH	pdispVal
VT_BSTR	bstrVal
VT_EMPTY	egyik sem

 

Ha VARIANT struktúrában kap információt, ellenőrizze a vt tagot, hogy megtudja, melyik tag tartalmaz érvényes adatokat. Hasonlóképpen, ha VARIANT struktúrával küld adatokat, mindig állítsa be vt az információkat tartalmazó szakszervezeti tagnak megfelelően.

A struktúra használata előtt inicializálja a VariantInit Component Object Model (COM) függvény meghívásával. Ha végzett a szerkezettel, törölje a jelet a VARIANT tartalmazó memória felszabadítása előtt a VariantClear meghívásával.