Struttura VARIANT

La maggior parte delle funzioni di Microsoft Active Accessibility e i metodi IAccessible 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.

vt Value Nome membro 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 di unione che contiene le informazioni.

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