PROPVARIANT 和 VARIANT 函数

本部分介绍一组用于 PROPVARIANTVARIANT 类型的 Windows Shell 转换和帮助程序函数。

主题 目录
ClearPropVariantArray 释放存储在数组中的 PROPVARIANT 结构数组使用的内存和引用。
ClearVariantArray 释放存储在数组中的 VARIANT 结构数组使用的内存和引用。
FreePropVariantArray 释放 PROPVARIANT 结构数组使用的内存和引用。
InitPropVariantFromBoolean 使用指定的布尔值将给定 PROPVARIANT 结构初始化为 VT_BOOL
InitPropVariantFromBooleanVector 从指定的布尔向量初始化 PROPVARIANT 结构。
InitPropVariantFromBuffer 使用缓冲区的内容初始化 PROPVARIANT 结构。
InitPropVariantFromCLSID 基于 CLSID) (类标识符初始化 PROPVARIANT 结构。
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 指定变体是否为数组。
IsVariantString 指定变体是否为字符串。
IsVarTypeFloat 返回 VARTYPE 是否为浮点数。
IsVarTypeInteger 返回 VARTYPE 是否为整数。
IsVarTypeNumber 指定 VARTYPE 是否为数字。
IsVarTypeSignedInteger 返回 VARTYPE 是否为带符号整数。
IsVarTypeUnsignedInteger 返回 VARTYPE 是否为无符号整数。
PropVariantChangeType 将存储为 PROPVARIANT 结构的值强制转换为不同变体类型的等效值。
PropVariantClear 清除 PROPVARIANT 结构。
PropVariantCompare 基于默认比较单位和设置比较两 个 PROPVARIANT 结构。
PropVariantCompareEx 通过允许调用方根据指定的比较单位和标志比较两个 PROPVARIANT 结构来扩展 PropVariantCompare
PropVariantCopy 创建 PROPVARIANT 结构的副本。
PropVariantGetBooleanElem 从 、 或 VT_ARRAY | VT_BOOL类型的 VT_BOOLVT_VECTOR | VT_BOOLPROPVARIANT 结构中提取单个布尔元素。
PropVariantGetDoubleElem 从 、 或 VT_ARRAY | VT_R8类型的 VT_R8VT_VECTOR | 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 提取存储在类型为 VT_ARRRAY 的 VARIANT 结构中的缓冲区的内容 |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 将变体结构的变体值提取到字符串。 如果无法提取任何值,则分配默认值。
VariantToStringAlloc 将变体结构的变体值提取到新分配的字符串。 如果无法提取任何值,则分配默认值。
VariantToStringArray 将数据从矢量结构提取到字符串数组中。
VariantToStringArrayAlloc 将数据从矢量结构提取到新分配的字符串数组中。
VariantToStringWithDefault 提取变体结构的字符串属性值。 如果不存在任何值,则返回指定的默认值。
VariantToStrRet 如果源变体是 VT_BSTR,则提取字符串并将其放入 STRRET 结构中。
VariantToUInt16 提取变体结构的无符号 Int16 属性值。 如果无法提取任何值,则此函数会分配默认值。
VariantToUInt16Array 将数据从矢量结构提取到无符号 Int16 数组中。
VariantToUInt16ArrayAlloc 将数据从矢量结构提取到新分配的无符号 Int16 数组中。
VariantToUInt16WithDefault 提取变体结构的无符号 Int16 属性值。 如果不存在值,则返回指定的默认值。
VariantToUInt32 提取变体结构的无符号 Int32 属性值。 如果无法提取任何值,则分配默认值。
VariantToUInt32Array 将数据从矢量结构提取到无符号 Int32 数组中。
VariantToUInt32ArrayAlloc 将数据从矢量结构提取到新分配的无符号 Int32 数组中。
VariantToUInt32WithDefault 提取变体结构的无符号 Int32 属性值。 如果当前不存在值,则返回指定的默认值。
VariantToUInt64 提取变体结构的无符号 Int64 属性值。 如果无法提取任何值,则分配默认值。
VariantToUInt64Array 将数据从矢量结构提取到无符号 Int64 数组中。
VariantToUInt64ArrayAlloc 将矢量结构中的数据提取到新分配的无符号 Int64 数组中。
VariantToUInt64WithDefault 提取变体结构的无符号 Int64 属性值。 如果当前不存在值,则返回指定的默认值。

 

属性包函数

函数