Struttura VARIANT

La maggior parte delle funzioni di Microsoft Active Accessibility e delle proprietà e dei metodi IAccessible accetta una struttura Variant come parametro. In pratica, 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 di Unione è valido. Sebbene la struttura Variant supporti molti tipi di dati diversi, Microsoft Active Accessibility utilizza solo i tipi seguenti.

Valore VT Nome del membro del valore corrispondente
VT _ I4 lVal
_invio VT pdispVal
_BSTR VT bstrVal
VT _ vuoto Nessuno

 

Quando si ricevono informazioni in una struttura Variant , controllare il membro VT per individuare il membro che contiene dati validi. Analogamente, quando si inviano informazioni utilizzando una struttura Variant , impostare sempre VT per riflettere il membro dell'Unione che contiene le informazioni.

Prima di utilizzare la struttura, inizializzarla chiamando la funzione VariantInit Component Object Model (com). Al termine della struttura, cancellarlo prima che la memoria che contiene la variante venga liberata chiamando VariantClear.