Compartilhar via


Estrutura VARIANT

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

O valor no primeiro membro da estrutura, vt, descreve qual dos membros da união é 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

 

Quando você recebe informações em uma estrutura VARIANT, marcar o membro vt para descobrir qual membro contém dados válidos. Da mesma forma, quando você envia informações usando uma estrutura VARIANT , sempre defina vt para refletir o membro da união que contém as informações.

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