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.