Función VariantToDoubleArrayAlloc (propvarutil.h)
Asigna una matriz de valores DOUBLE y extrae los datos de una estructura VARIANT en esa matriz.
Sintaxis
PSSTDAPI VariantToDoubleArrayAlloc(
[in] REFVARIANT var,
[out] DOUBLE **pprgn,
[out] ULONG *pcElem
);
Parámetros
[in] var
Tipo: REFVARIANT
Referencia a una estructura VARIANT de origen.
[out] pprgn
Tipo: DOUBLE**
Cuando esta función devuelve , contiene un puntero a una matriz de valores DOUBLE extraídos de la estructura VARIANT de origen.
[out] pcElem
Tipo: ULONG*
Cuando esta función vuelve, contiene un puntero al recuento de elementos extraídos de la estructura VARIANT de origen.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Esta función auxiliar se usa cuando la aplicación que realiza la llamada espera que variant contenga una matriz de valores DOUBLE .
Si el valor VARIANT de origen es de tipo VT_ARRAY | VT_R8, esta función extrae una matriz de valores DOUBLE en una matriz recién asignada. La aplicación que realiza la llamada es responsable de usar CoTaskMemFree para liberar la matriz a la que apunta pprgn cuando ya no es necesaria.
Ejemplos
En el ejemplo siguiente, para incluirse como parte de un programa mayor, se muestra cómo usar VariantToDoubleArrayAlloc para tener acceso a un valor de matriz DOUBLE en un variant.
// VARIANT var;
// Assume variable var is initialized and valid.
// The application expects var to contain an array of DOUBLE values.
DOUBLE *prgDoubles;
ULONG cElems;
HRESULT hr = VariantToDoubleArrayAlloc(var, &prgDoubles, &cElems);
if (SUCCEEDED(hr))
{
// prgDoubles now points to a vector of cElems DOUBLEs.
CoTaskMemFree(prgDoubles);
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | propvarutil.h |
| Library | Propsys.lib |
| Archivo DLL | Propsys.dll (versión 6.0 o posterior) |
| Redistribuible | Windows Desktop Search (WDS) 3.0 |