Estrutura VARIANT

A maioria das funções de Acessibilidade Ativa da Microsoft e as propriedades e métodos deIAccessible têm uma estruturaVARIANTcomo parâmetro. Essencialmente, a estrutura VARIANT é um contêiner para uma grande união que carrega muitos tipos de dados.

O valor no primeiro membro da estrutura, vt, descreve qual dos membros do sindicato é válido. Embora a estrutura VARIANT dê suporte a muitos tipos de dados diferentes, a Acessibilidade Ativa da Microsoft usa apenas os tipos a seguir.

Valor vt	Nome do membro do valor correspondente
VT_I4	lVal
VT_DISPATCH	pdispVal
VT_BSTR	bstrVal
VT_EMPTY	nenhum

 

Ao receber informações em uma estrutura deVARIANT, verifique o membro vt para descobrir qual membro contém dados válidos. Da mesma forma, ao enviar informações usando uma estrutura de VARIANT, sempre defina vt para refletir o membro do sindicato que contém as informações.

Antes de usar a estrutura, inicialize-a chamando a função VariantInit Component Object Model (COM). Quando terminar com a estrutura, desmarque-a antes que a memória que contém o VARIANT seja liberada chamando VariantClear.