共用方式為

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 屬性值。 如果目前沒有任何值存在，則會傳回指定的預設值。

 

屬性包函式

函式

 

 

  • Last updated on