Fonction PropVariantGetElementCount (propvarutil.h)

Récupère le nombre d’éléments d’une structure PROPVARIANT .

Syntaxe

PSSTDAPI_(ULONG) PropVariantGetElementCount(
  [in] REFPROPVARIANT propvar
);

Paramètres

[in] propvar

Type : REFPROPVARIANT

Référence à la structure PROPVARIANT source.

Valeur retournée

Type : ULONG

Renvoie le nombre d’éléments d’une valeur VT_VECTOR ou VT_ARRAY : pour les valeurs uniques, retourne 1 ; pour les structures vides, retourne 0.

Remarques

Cette fonction fonctionne pour tous les types PROPVARIANT valides. Pour connaître les combinaisons de types valides, consultez PROPVARIANT .

Cette fonction est utile pour obtenir le nombre d’éléments à itérer à l’aide d’une instruction de boucle, en particulier pour les itérations qui appellent des fonctions telles que PropVariantGetUInt32Elem ou PropVariantGetElem.

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