Struttura VARIANT

La maggior parte delle funzioni di Accessibilità attiva Microsoft e delle proprietà e dei metodi IAccessi accettano una struttura VARIANT come parametro. Essenzialmente, la struttura VARIANT è un contenitore per un'unione di grandi dimensioni che contiene molti tipi di dati.

Il valore nel primo membro della struttura, vt, descrive quale dei membri dell'unione è valido. Anche se la struttura VARIANT supporta molti tipi di dati diversi, Microsoft Active Accessibility usa solo i tipi seguenti.

Valore vt	Nome membro del valore corrispondente
VT_I4	lVal
VT_DISPATCH	pdispVal
VT_BSTR	bstrVal
VT_EMPTY	Nessuno

 

Quando si ricevono informazioni in una struttura VARIANT , controllare il membro vt per scoprire quale membro contiene dati validi. Analogamente, quando si inviano informazioni usando una struttura VARIANT , impostare sempre vt per riflettere il membro dell'unione che contiene le informazioni.

Prima di usare la struttura, inizializzarla chiamando la funzione VariantInit Component Object Model (COM). Al termine della struttura, cancellarlo prima che la memoria contenente l'oggetto VARIANT venga liberata chiamando VariantClear.