Fonction VariantToDoubleArrayAlloc (propvarutil.h)
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 |