VARIANT 結構

  • 發行項

大部分的 Microsoft Active Accessibility 函式和 IAccessible 屬性和方法都會採用 VARIANT 結構做為參數。 基本上， VARIANT 結構是具有許多資料類型之大型聯集的容器。

結構第一個成員 vt中的值會描述哪一個聯集成員有效。 雖然 VARIANT 結構支援許多不同的資料類型，但 Microsoft Active Accessibility 只會使用下列類型。

vt 值 對應的值成員名稱
VT_I4 lVal
VT_DISPATCH pdispVal
VT_BSTR bstrVal
VT_EMPTY 無

 

當您在 VARIANT 結構中收到資訊時，請檢查 vt 成員，以找出哪些成員包含有效的資料。 同樣地，當您使用 VARIANT 結構傳送資訊時，一律將 vt 設定為反映包含資訊的聯集成員。

使用 結構之前，請先呼叫 VariantInit 元件物件模型 (COM) 函式加以初始化。 當結構完成時，請先清除它，再呼叫VariantClear釋放包含VARIANT的記憶體。