通过

InitPropVariantVectorFromPropVariant 函数 (propvarutil.h)

  • 项目

使用存储在另一个 PROPVARIANT 中的值初始化 PROPVARIANT 结构中的向量元素。

语法

PSSTDAPI InitPropVariantVectorFromPropVariant(
  [in]  REFPROPVARIANT propvarSingle,
  [out] PROPVARIANT    *ppropvarVector
);

参数

[in] propvarSingle

类型： REFPROPVARIANT

对包含单个值的源 PROPVARIANT 结构的引用。

[out] ppropvarVector

类型： PROPVARIANT*

当此函数返回时，包含初始化的 PROPVARIANT 结构。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

此函数用于将包含单个值的 PROPVARIANT 结构转换为矢量值。

对于简单源类型，此函数将 PROPVARIANT 初始化为一个元素的向量。

对于包含字符串的源，此函数使用从源字符串获取的零个或多个子字符串初始化 PROPVARIANT ，并将分号视为分隔符。 有关更多详细信息，请参阅 InitPropVariantFromStringAsVector 。

支持以下输入类型：

  • VT_I2
  • VT_UI2
  • VT_I4
  • VT_UI4
  • VT_I8
  • VT_UI8
  • VT_R8
  • VT_BOOL
  • VT_DATE
  • VT_FILETIME
  • VT_BSTR
  • VT_LPWSTR
将来可能支持其他类型。

示例

以下示例将作为较大程序的一部分包含，演示如何使用 InitPropVariantVectorFromPropVariant。

// PROPVARIANT propvarSource;
// Assume propvarSource is initialized and valid.

if (PropVariantGetElementCount(propvarSource) == 1)
{
    PROPVARIANT propvar;

    HRESULT hr = InitPropVariantVectorFromPropVariant(propvarSource, &propvar);

    if (SUCCEEDED(hr))
    {
       // propvar now is valid and is either VT_EMPTY or contains a vector.
       PropVariantClear(&propvar);
    }

要求

要求 值
最低受支持的客户端 Windows XP SP2、Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 propvarutil.h
Library Propsys.lib
DLL Propsys.dll (版本 6.0 或更高版本)
可再发行组件 Windows 桌面搜索 (WDS) 3.0

另请参阅

InitPropVariantFromStringAsVector

PropVariantGetElem

PropVariantGetElementCount