VariantToDoubleArray 函数 (propvarutil.h)

项目
03/01/2024

从 VARIANT 结构中提取 DOUBLE 值的数组。

语法

PSSTDAPI VariantToDoubleArray(
  [in]  REFVARIANT var,
  [out] DOUBLE     *prgn,
  [in]  ULONG      crgn,
  [out] ULONG      *pcElem
);

参数

[in] var

类型： REFVARIANT

对源 VARIANT 结构的引用。

[out] prgn

类型： DOUBLE*

指向包含 crgnDOUBLE 值的缓冲区的指针。当此函数返回时，缓冲区已使用从源 VARIANT 结构中提取的 *pcElemDOUBLE 元素初始化。

[in] crgn

类型： ULONG

prgn 指向的缓冲区中的元素数。

[out] pcElem

类型： ULONG*

当此函数返回时，包含从源 VARIANT 结构中提取的 DOUBLE 元素的计数。

返回值

类型： HRESULT

如果成功，则返回 S_OK ，否则返回错误值，包括：

返回代码	说明
TYPE_E_BUFFERTOOSMALL	源 VARIANT 包含的不仅仅是 crgn 值。
E_INVALIDARG	VARIANT 不是适当的类型。

注解

当调用应用程序希望 VARIANT 保存由固定数量的 DOUBLE 值组成的数组时，使用此帮助程序函数。

如果源 VARIANT 的类型为 VT_ARRAY |VT_DOUBLE，此函数提取最多 crgnDOUBLE 值，并将其放入 prgn 指向的缓冲区中。

如果 VARIANT 包含的元素数超过 将放入 prgn 缓冲区的元素，则此函数将返回错误并将 *pcElem 设置为 0。

示例

以下示例将作为较大程序的一部分包含，演示如何使用 VariantToDoubleArray 访问 VARIANT 中存储的DOUBLE 数组。

// VARIANT var;
// Assume variable var is initialized and valid.
DOUBLE rgDoubles[4]; // The application expects var to hold 4 DOUBLEs in an array.
ULONG cDoubles;

HRESULT hr = VariantToDoubleArray(var, rgDoubles, ARRAYSIZE(rgDoubles), &cFlags);

if (SUCCEEDED(hr))
{
    if (cFlags == ARRAYSIZE(rgDoubles))
    {
        // The application got 4 DOUBLEs which are now stored in rgDoubles.
    }
    else
    {
        // The application got *pcElem DOUBLEs which are stored in the first 
        // *pcElem elements of rgDoubles.
    }
}

要求

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