PropVariantGetDoubleElem, fonction (propvarutil.h)

Article
08/25/2023

Extrait un seul élément double d’une structure PROPVARIANT de type VT_R8, VT_VECTOR | VT_R8ou VT_ARRAY | VT_R8.

Syntaxe

PSSTDAPI PropVariantGetDoubleElem(
  [in]  REFPROPVARIANT propvar,
  [in]  ULONG          iElem,
  [out] DOUBLE         *pnVal
);

Paramètres

[in] propvar

Type : REFPROPVARIANT

Référence à la structure PROPVARIANT source.

[in] iElem

Type : ULONG

Spécifie l’index de vecteur ou de tableau ; sinon, iElem doit être 0.

[out] pnVal

Type : DOUBLE*

Lorsque cette fonction est retournée, contient la valeur double extraite.

Valeur retournée

Type : HRESULT

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

Notes

Si la source PROPVARIANT a le type VT_R8, iElem doit être 0. Sinon, iElem doit être inférieur au nombre d’éléments dans le vecteur ou le tableau. Vous pouvez utiliser PropVariantGetElementCount pour obtenir le nombre d’éléments dans le vecteur ou le tableau.

L’exemple suivant utilise cette fonction pour parcourir en boucle les valeurs d’une structure PROPVARIANT .

Exemples

// PROPVARIANT propvar;
// assume propvar is initialized and valid

if ((propvar.vt & VT_TYPEMASK) == VT_R8)
{
    UINT cElem = PropVariantGetElementCount(propvar);
    HRESULT hr = <mark type="const">S_OK</mark>;
    
    for (UINT iElem = 0; SUCCEEDED(hr) && iElem < cElem; iElem ++)
    {
        DOUBLE nValue;
        hr = PropVariantGetDoubleElem(propvar, iElem, &nValue);
    
        if (SUCCEEDED(hr))
        {
            // nValue is valid now
        }
    }
}

Spécifications


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

Voir aussi

PropVariantGetElem

Partager via