PROPVARIANT 和 VARIANT 函式

本節描述一組搭配 PROPVARIANT 和 VARIANT 類型使用的 Windows Shell 轉換和協助程式函式。

主題	目錄
ClearPropVariantArray	釋放儲存在陣列中 之 PROPVARIANT 結構的陣列所使用的記憶體和參考。
ClearVariantArray	釋放儲存在陣列中 VARIANT 結構的陣列所使用的記憶體和參考。
FreePropVariantArray	釋放 PROPVARIANT 結構的陣列所使用的記憶體和參考。
InitPropVariantFromBoolean	使用指定的布林值，將指定的 PROPVARIANT 結構初始化為 VT_BOOL 。
InitPropVariantFromBooleanVector	從指定的布林向量初始化 PROPVARIANT 結構。
InitPropVariantFromBuffer	使用緩衝區的內容，初始化 PROPVARIANT 結構。
InitPropVariantFromCLSID	根據類別識別碼初始化 PROPVARIANT 結構， (CLSID) 。
InitPropVariantFromDouble	根據指定的雙精度浮點數，初始化PROPVARIANT結構。
InitPropVariantFromDoubleVector	根據雙精度浮點數的指定向量，初始化PROPVARIANT結構。
InitPropVariantFromFileTime	根據儲存在FILETIME結構中的資訊，初始化PROPVARIANT結構。
InitPropVariantFromFileTimeVector	從指定的FILETIME值向量初始化PROPVARIANT結構。
InitPropVariantFromGUIDAsBuffer	根據GUID初始化PROPVARIANT結構。 結構會初始化為VT_VECTOR VT_UI1 | 。
InitPropVariantFromGUIDAsString	根據GUID初始化PROPVARIANT結構。 結構會初始化為 VT_LPWSTR。
InitPropVariantFromInt16	根據 16 位整數值，初始化 PROPVARIANT 結構。
InitPropVariantFromInt16Vector	根據 16 位整數值的指定向量，初始化 PROPVARIANT 結構。
InitPropVariantFromInt32	根據 32 位整數值，初始化 PROPVARIANT 結構。
InitPropVariantFromInt32Vector	根據 32 位整數值的向量，初始化 PROPVARIANT 結構。
InitPropVariantFromInt64	根據指定的Int64值，初始化PROPVARIANT結構。
InitPropVariantFromInt64Vector	根據Int64值的向量，初始化PROPVARIANT結構。
InitPropVariantFromPropVariantVectorElem	根據指定的 PROPVARIANT 向量專案，初始化 PROPVARIANT 結構。
InitPropVariantFromResource	根據內嵌在可執行檔中的字串資源，初始化 PROPVARIANT 結構。
InitPropVariantFromString	根據指定的字串，初始化 PROPVARIANT 結構。
InitPropVariantFromStringAsVector	從指定的字串初始化 PROPVARIANT 結構。 字串會剖析為分號分隔清單 (例如：「A;B;C「) 。
InitPropVariantFromStringVector	從指定的字串向量初始化 PROPVARIANT 結構。
InitPropVariantFromStrRet	根據儲存在 STRRET結構中的字串，初始化PROPVARIANT結構。
InitPropVariantFromUInt16	根據 16 位不帶正負號的整數值，初始化 PROPVARIANT 結構。
InitPropVariantFromUInt16Vector	根據 16 位不帶正負號的整數值的向量，初始化 PROPVARIANT 結構。
InitPropVariantFromUInt32	根據 32 位不帶正負號的整數值，初始化 PROPVARIANT 結構。
InitPropVariantFromUInt32Vector	根據 32 位不帶正負號的整數值的向量，初始化 PROPVARIANT 結構。
InitPropVariantFromUInt64	使用 64 位不帶正負號的整數值，初始化 PROPVARIANT 結構。
InitPropVariantFromUInt64Vector	根據 64 位不帶正負號的整數的向量，初始化 PROPVARIANT 結構。
InitPropVariantVectorFromPropVariant	使用儲存在另一個PROPVARIANT中的值，初始化 PROPVARIANT結構中的向量專案。
InitVariantFromBoolean	使用布林值初始化 VARIANT 結構。
InitVariantFromBooleanArray	從布林值陣列初始化 VARIANT 結構。
InitVariantFromBuffer	使用緩衝區的內容，初始化 VARIANT 結構。
InitVariantFromDispatch	根據IDispatch物件的實例，初始化VARIANT結構。
InitVariantFromDosDateTime	使用 Microsoft MS-DOS 所使用的格式指定日期和時間，初始化 VARIANT 結構。 日期和時間值會轉換成用來在 VARIANT中儲存日期和時間的格式。
InitVariantFromDouble	使用DOUBLE類型的值，初始化VARIANT結構。
InitVariantFromDoubleArray	使用DOUBLE類型的值陣列，初始化VARIANT結構。
InitVariantFromFileTime	使用FILETIME結構的內容，初始化VARIANT結構。
InitVariantFromFileTimeArray	使用FILETIME結構的陣列，初始化VARIANT結構。
InitVariantFromGUIDAsBuffer	根據GUID初始化VARIANT結構。 結構會初始化為VT_ARRAY | VT_UI1。
InitVariantFromInt16	根據 16 位整數值，初始化 PROPVARIANT 結構。
InitVariantFromInt16Array	使用 16 位整數值的陣列，初始化 VARIANT 結構。
InitVariantFromInt32	根據 32 位整數值，初始化 PROPVARIANT 結構。
InitVariantFromInt32Array	使用 32 位整數值的陣列，初始化 VARIANT 結構。
InitVariantFromInt64	使用 64 位整數值初始化 VARIANT 結構。
InitVariantFromInt64Array	使用 64 位整數值的陣列，初始化 VARIANT 結構。
InitVariantFromResource	根據可執行檔中內嵌的字串資源，初始化 VARIANT 結構。
InitVariantFromString	使用字串初始化 VARIANT 結構。
InitVariantFromStringArray	使用字串陣列初始化 VARIANT 結構。
InitVariantFromStrRet	使用儲存在 STRRET結構中的字串，初始化VARIANT結構。
InitVariantFromUInt16	使用不帶正負號的 16 位整數值，初始化 VARIANT 結構。
InitVariantFromUInt16Array	使用不帶正負號的 16 位整數值的陣列，初始化 VARIANT 結構。
InitVariantFromUInt32	使用不帶正負號的 32 位整數值，初始化 VARIANT 結構。
InitVariantFromUInt32Array	使用不帶正負號的 32 位整數值的陣列，初始化 VARIANT 結構。
InitVariantFromUInt64	使用不帶正負號的 64 位整數值，初始化 VARIANT 結構。
InitVariantFromUInt64Array	使用不帶正負號的 64 位整數值，初始化 VARIANT 結構。
InitVariantFromVariantArrayElem	使用儲存在另一個 VARIANT 結構中的值，初始化 VARIANT 結構。
IsPropVariantString	指定指定的 PROPVARIANT 結構是否為字串類型。
IsPropVariantVector	指定 PROPVARIANT 結構是否有向量類型。
IsVariantArray	指定 Variant 是否為數組。
IsVariantString	指定 Variant 是否為字串。
IsVarTypeFloat	傳回 VARTYPE 是否為 float。
IsVarTypeInteger	傳回 VARTYPE 是否為整數。
IsVarTypeNumber	指定 VARTYPE 是否為數字。
IsVarTypeSignedInteger	傳回 VARTYPE 是否為帶正負號的整數。
IsVarTypeUnsignedInteger	傳回 VARTYPE 是否為不帶正負號的整數。
PropVariantChangeType	將儲存為 PROPVARIANT 結構的值強制成不同變體類型的對等值。
PropVariantClear	清除 PROPVARIANT 結構。
PropVariantCompare	根據預設比較單位和設定，比較兩個 PROPVARIANT 結構。
PropVariantCompareEx	藉由允許呼叫端根據指定的比較單位和旗標來比較兩個PROPVARIANT結構，以擴充PropVariantCompare。
PropVariantCopy	建立 PROPVARIANT 結構的複本。
PropVariantGetBooleanElem	從 、 VT_VECTOR | VT_BOOL 或 VT_ARRAY | VT_BOOL 類型的 VT_BOOLPROPVARIANT結構擷取單一布林專案。
PropVariantGetDoubleElem	從 、 VT_VECTOR | VT_R8 或 VT_ARRAY | VT_R8 類型的 VT_R8PROPVARIANT結構擷取單一雙元素。
PropVariantGetElem	根據另一個 PROPVARIANT 結構中的指定專案，初始化 PROPVARIANT 結構。
PropVariantGetElementCount	擷取 PROPVARIANT 結構的專案計數。
PropVariantGetFileTimeElem	從類型為 VT_FILETIME 的PROPVARIANT結構擷取單一FILETIME元素，VT_VECTOR |VT_FILETIME或VT_ARRAY |VT_FILETIME。
PropVariantGetInt16Elem	從類型為 VT_I2 的 PROPVARIANT 結構擷取單一 Int16 元素，VT_VECTOR |VT_I2或VT_ARRAY |VT_I2。
PropVariantGetInt32Elem	從類型為 VT_I4 的 PROPVARIANT 擷取單一 Int32 元素，VT_VECTOR |VT_I4或VT_ARRAY |VT_I4。
PropVariantGetInt64Elem	從類型為 VT_I8 的PROPVARIANT結構擷取單一Int64元素，VT_VECTOR |VT_I8或VT_ARRAY |VT_I8。
PropVariantGetStringElem	從類型為 VT_LPWSTR、VT_BSTR、VT_VECTOR 的 PROPVARIANT 結構擷取單一 Unicode 字串專案 |VT_LPWSTR，VT_VECTOR |VT_BSTR或VT_ARRAY |VT_BSTR。
PropVariantGetUInt16Elem	從類型為 VT_U12 的 PROPVARIANT 結構擷取單一無符號的 Int16 元素，VT_VECTOR |VT_U12或VT_ARRAY |VT_U12。
PropVariantGetUInt32Elem	從類型為 VT_UI4 的 PROPVARIANT 結構擷取單一無符號的 Int32 元素，VT_VECTOR |VT_UI4或VT_ARRAY |VT_UI4。
PropVariantGetUInt64Elem	從類型為 VT_UI8 的PROPVARIANT結構擷取單一無符號Int64元素，VT_VECTOR |VT_UI8或VT_ARRAY |VT_UI8。
PropVariantToBoolean	擷取 PROPVARIANT 結構的布林屬性值。 如果無法擷取任何值，則會指派預設值。
PropVariantToBooleanVector	從 PROPVARIANT 結構擷取布林向量。
PropVariantToBooleanVectorAlloc	將資料從 PROPVARIANT 結構擷取至新配置的布林向量。
PropVariantToBooleanWithDefault	擷取 PROPVARIANT 結構的布林屬性值。 如果沒有值存在，則會傳回指定的預設值。
PropVariantToBSTR	擷取 PROPVARIANT 結構的 BSTR 屬性值。
PropVariantToBuffer	從類型為 VT_VECTOR 的 PROPVARIANT 結構擷取緩衝區值 |VT_UI1或VT_ARRRAY |VT_UI1。
PropVariantToCLSID	擷取 PROPVARIANT 結構的 CLSID 屬性值。
PropVariantToDouble	從 PROPVARIANT 結構擷取雙精度浮點數。
PropVariantToDoubleVector	從 PROPVARIANT 結構擷取雙精度浮點數的向量。
PropVariantToDoubleVectorAlloc	將資料從 PROPVARIANT 結構擷取到新配置的雙向量。
PropVariantToDoubleWithDefault	擷取 PROPVARIANT 結構的 double 屬性值。 如果沒有值存在，則會傳回指定的預設值。
PropVariantToFileTime	從PROPVARIANT結構擷取FILETIME結構。
PropVariantToFileTimeVector	將資料從 PROPVARIANT 結構擷取到 FILETIME 向量。
PropVariantToFileTimeVectorAlloc	將資料從 PROPVARIANT 結構擷取到新配置的 FILETIME 向量。
PropVariantToGUID	從 PROPVARIANT 結構擷取 GUID 值。
PropVariantToInt16	擷取PROPVARIANT結構的Int16屬性值。
PropVariantToInt16Vector	從PROPVARIANT結構擷取Int16值的向量。
PropVariantToInt16VectorAlloc	將資料從 PROPVARIANT 結構擷取到新配置的 Int16 向量。
PropVariantToInt16WithDefault	擷取PROPVARIANT結構的Int16屬性值。 如果目前沒有任何值存在，則會傳回指定的預設值。
PropVariantToInt32	擷取PROPVARIANT結構的Int32屬性值。 如果無法擷取任何值，則會指派預設值。
PropVariantToInt32Vector	從PROPVARIANT結構擷取長值的向量。
PropVariantToInt32VectorAlloc	將資料從 PROPVARIANT 結構擷取到新配置的 Int32 向量。
PropVariantToInt32WithDefault	從PROPVARIANT結構擷取ULONG值。 如果沒有值存在，則會傳回指定的預設值。
PropVariantToInt64	從PROPVARIANT結構擷取LONGLONG值。 如果無法擷取任何值，則會指派預設值。
PropVariantToInt64Vector	將資料從 PROPVARIANT 結構擷取到 Int64 向量。
PropVariantToInt64VectorAlloc	將資料從 PROPVARIANT 結構擷取到新配置的 LONGLONG 向量。
PropVariantToInt64WithDefault	擷取PROPVARIANT結構的Int64屬性值。 如果沒有值存在，則會傳回指定的預設值。
PropVariantToString	從 PROPVARIANT 結構擷取字串值。
PropVariantToStringAlloc	從 PROPVARIANT 結構擷取字串屬性值。
PropVariantToStringVector	從 PROPVARIANT 結構擷取字串的向量。
PropVariantToStringVectorAlloc	將資料從 PROPVARIANT 結構擷取到新配置的向量中新配置的字串。
PropVariantToStringWithDefault	擷取 PROPVARIANT 結構的字串屬性值。 如果沒有值存在，則會傳回指定的預設值。
PropVariantToStrRet	從 PROPVARIANT 結構擷取字串，並將它放入 STRRET 結構中。
PropVariantToUInt16	從PROPVARIANT結構擷取不帶正負號的簡短值。 如果無法擷取任何值，則會指派預設值。
PropVariantToUInt16Vector	根據 16 位不帶正負號的整數值，初始化 PROPVARIANT 結構。
PropVariantToUInt16VectorAlloc	將資料從 PROPVARIANT 結構擷取到 不帶正負號的短 向量。
PropVariantToUInt16WithDefault	從PROPVARIANT結構擷取不帶正負號的簡短值。 如果沒有值存在，則會傳回指定的預設值。
PropVariantToUInt32	從PROPVARIANT結構擷取ULONG值。 如果無法擷取任何值，則會指派預設值。
PropVariantToUInt32Vector	將資料從 PROPVARIANT 結構擷取到 ULONG 向量。
PropVariantToUInt32VectorAlloc	將資料從 PROPVARIANT 結構擷取到新配置的 ULONG 向量。
PropVariantToUInt32WithDefault	從PROPVARIANT結構擷取ULONG值。 如果沒有值存在，則會傳回指定的預設值。
PropVariantToUInt64	從PROPVARIANT結構擷取UInt64值。 如果無法擷取任何值，則會指派預設值。
PropVariantToUInt64Vector	將資料從 PROPVARIANT 結構擷取到 ULONGLONG 向量。
PropVariantToUInt64VectorAlloc	將資料從 PROPVARIANT 結構擷取到新配置的 ULONGLONG 向量。
PropVariantToUInt64WithDefault	從PROPVARIANT結構擷取ULONGLONG值。 如果沒有值存在，則會傳回指定的預設值。
PropVariantToVariant	將 PROPVARIANT 結構的內容轉換為 VARIANT 結構。
StgDeserializePropVariant	還原序列化指定的 SERIALIZEDPROPERTYVALUE 結構，建立 PROPVARIANT 結構。
StgSerializePropVariant	序列化指定的 PROPVARIANT 結構，建立 SERIALIZEDPROPERTYVALUE 結構。
VariantCompare	根據預設比較規則，比較兩個變體結構。
VariantGetBooleanElem	從變體結構擷取單一布林專案。
VariantGetDoubleElem	從變體結構擷取一個 雙精度 浮點數元素。
VariantGetElem	從指定的 Variant 專案初始化 VARIANT 結構。
VariantGetElementCount	擷取變體結構的專案計數。
VariantGetInt16Elem	從變體結構中擷取單一 Int16 元素。
VariantGetInt32Elem	從變體結構中擷取單一 Int32 元素。
VariantGetInt64Elem	從變體結構擷取單一 Int64 元素。
VariantGetStringElem	從變體結構擷取單一寬字元串專案。
VariantGetUInt16Elem	從變體結構中擷取單一未帶正負號 的 Int16 元素。
VariantGetUInt32Elem	從變體結構中擷取單一未帶正負號 的 Int32 元素。
VariantGetUInt64Elem	從變體結構中擷取單一未帶正負號 的 Int64 元素。
VariantToBoolean	從 VARIANT 結構擷取布林屬性值。 如果無法擷取任何值，則會指派預設值。
VariantToBooleanArray	從 VARIANT 結構擷取布林值陣列。
VariantToBooleanArrayAlloc	配置 BOOL 值的陣列，然後將 VARIANT 結構中的資料擷取到該陣列。
VariantToBooleanWithDefault	從VARIANT結構擷取BOOL值。 如果沒有值存在，則會傳回指定的預設值。
VariantToBuffer	擷取儲存在 VARIANT 結構中類型VT_ARRRAY的緩衝區內容 |VT_UI1。
VariantToDosDateTime	從 VARIANT 結構擷取 MS-DOS 格式的日期和時間值。
VariantToDouble	從VARIANT結構擷取DOUBLE值。 如果無法擷取任何值，則會指派預設值。
VariantToDoubleArray	從VARIANT結構擷取DOUBLE值的陣列。
VariantToDoubleArrayAlloc	配置 DOUBLE 值的陣列，然後將 VARIANT 結構中的資料擷取到該陣列。
VariantToDoubleWithDefault	從VARIANT結構擷取DOUBLE值。 如果沒有值存在，則會傳回指定的預設值。
VariantToFileTime	從變體結構擷取 FILETIME 結構。
VariantToGUID	擷取變體結構的 GUID 屬性值。
VariantToInt16	擷取變體結構的未帶正負號 Int16 屬性值。 如果無法擷取任何值，則此函式會指派預設值。
VariantToInt16Array	將資料從向量結構擷取到 Int16 陣列。
VariantToInt16ArrayAlloc	將資料從向量結構擷取到新配置的 Int16 陣列。
VariantToInt16WithDefault	擷取變體結構的 Int16 屬性值。 如果沒有值存在，則會傳回指定的預設值。
VariantToInt32	擷取變體結構的 Int32 屬性值。 如果無法擷取任何值，則會指派預設值。
VariantToInt32Array	將資料從向量結構擷取到 Int32 陣列。
VariantToInt32ArrayAlloc	將資料從向量結構擷取到新配置的 Int32 陣列。
VariantToInt32WithDefault	擷取變體結構的 Int32 屬性值。 如果沒有值存在，則會傳回指定的預設值。
VariantToInt64	擷取變體結構的 Int64 屬性值。 如果無法擷取任何值，則會指派預設值。
VariantToInt64Array	將資料從向量結構擷取到 Int64 陣列。
VariantToInt64ArrayAlloc	將資料從向量結構擷取到新配置的 Int64 陣列。
VariantToInt64WithDefault	擷取變體結構的 Int64 屬性值。 如果沒有值存在，則會傳回指定的預設值。
VariantToPropVariant	將 VARIANT 結構的內容複寫到 PROPVARIANT 結構。
VariantToString	將變體結構的 variant 值擷取至字串。 如果無法擷取任何值，則會指派預設值。
VariantToStringAlloc	將變體結構的變異值擷取至新配置的字串。 如果無法擷取任何值，則會指派預設值。
VariantToStringArray	將資料從向量結構擷取到字串陣列。
VariantToStringArrayAlloc	將資料從向量結構擷取到新配置的字串陣列。
VariantToStringWithDefault	擷取變體結構的字串屬性值。 如果沒有值存在，則會傳回指定的預設值。
VariantToStrRet	如果來源變體是 VT_BSTR，則會擷取字串，並將其放入 STRRET 結構中。
VariantToUInt16	擷取變體結構的未帶正負號 Int16 屬性值。 如果無法擷取任何值，則此函式會指派預設值。
VariantToUInt16Array	將資料從向量結構擷取至未帶正負號 的 Int16 陣列。
VariantToUInt16ArrayAlloc	將資料從向量結構擷取到新配置的未簽署 Int16 陣列。
VariantToUInt16WithDefault	擷取變體結構的未帶正負號 Int16 屬性值。 如果沒有值存在，則會傳回指定的預設值。
VariantToUInt32	擷取 Variant 結構的不帶正負號 Int32 屬性值。 如果無法擷取任何值，則會指派預設值。
VariantToUInt32Array	將資料從向量結構擷取到不帶正負號 的 Int32 陣列。
VariantToUInt32ArrayAlloc	將資料從向量結構擷取到新配置的未帶正負號 Int32 陣列。
VariantToUInt32WithDefault	擷取 Variant 結構的不帶正負號 Int32 屬性值。 如果目前沒有任何值存在，則會傳回指定的預設值。
VariantToUInt64	擷取變體結構的不帶正負號 Int64 屬性值。 如果無法擷取任何值，則會指派預設值。
VariantToUInt64Array	將資料從向量結構擷取到不帶正負號 的 Int64 陣列。
VariantToUInt64ArrayAlloc	將資料從向量結構擷取到新配置的未簽署 Int64 陣列。
VariantToUInt64WithDefault	擷取 Variant 結構的不帶正負號 Int64 屬性值。 如果目前沒有任何值存在，則會傳回指定的預設值。

 

相關主題

屬性包函式

函式