Partilhar via


Estrutura VARIANTE

A maioria das funções do Microsoft Ative Accessibility e as propriedades e métodos IAccessible tomam uma VARIANT estrutura como 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 estruturaVARIANTofereça suporte a muitos tipos de dados diferentes, o Microsoft Ative Accessibility usa apenas os seguintes tipos.

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

 

Quando você receber informações em uma estruturaVARIANT, verifique o vt membro para descobrir qual membro contém dados válidos. Da mesma forma, quando você envia informações usando uma VARIANT estrutura, 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 a estrutura, limpe-a antes que a memória que contém o VARIANT seja liberada chamando VariantClear.