Fonction VariantToDoubleArrayAlloc (propvarutil.h)

Article
03/04/2024

Alloue un tableau de valeurs DOUBLE , puis extrait les données d’une structure VARIANT dans ce tableau.

Syntaxe

PSSTDAPI VariantToDoubleArrayAlloc(
  [in]  REFVARIANT var,
  [out] DOUBLE     **pprgn,
  [out] ULONG      *pcElem
);

Paramètres

[in] var

Type : REFVARIANT

Référence à une structure VARIANT source.

[out] pprgn

Type : DOUBLE**

Lorsque cette fonction retourne, contient un pointeur vers un tableau de valeurs DOUBLE extraites de la structure VARIANT source.

[out] pcElem

Type : ULONG*

Lorsque cette fonction retourne, contient un pointeur vers le nombre d’éléments extraits de la structure VARIANT source.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette fonction d’assistance est utilisée lorsque l’application appelante s’attend à ce qu’un VARIANT contienne un tableau de valeurs DOUBLE .

Si le VARIANT source est de type VT_ARRAY | VT_R8, cette fonction extrait un tableau de valeurs DOUBLE dans un tableau nouvellement alloué. L’application appelante est responsable de l’utilisation de CoTaskMemFree pour libérer le tableau pointé par pprgn lorsqu’il n’est plus nécessaire.

Exemples

L’exemple suivant, à inclure dans le cadre d’un programme plus grand, montre comment utiliser VariantToDoubleArrayAlloc pour accéder à une valeur de tableau DOUBLE dans 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);
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propvarutil.h
Bibliothèque	Propsys.lib
DLL	Propsys.dll (version 6.0 ou ultérieure)
Composant redistribuable	Windows Desktop Search (WDS) 3.0