PropVariantGetElementCount-Funktion (propvarutil.h)

Ruft die Elementanzahl einer PROPVARIANT-Struktur ab.

Syntax

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

Parameter

[in] propvar

Typ: REFPROPVARIANT

Verweis auf die PROPVARIANT-Quellstruktur .

Rückgabewert

Typ: ULONG

Gibt die Elementanzahl eines VT_VECTOR- oder VT_ARRAY-Werts zurück: für einzelne Werte gibt 1 zurück; für leere Strukturen gibt 0 zurück.

Hinweise

Diese Funktion funktioniert für alle gültigen PROPVARIANT-Typen . Die gültigen Typkombinationen finden Sie unter PROPVARIANT .

Diese Funktion ist nützlich, um die Anzahl der zu durchlaufenden Elemente mithilfe einer Schleifenanweisung abzurufen, insbesondere für Iterationen, die Funktionen wie PropVariantGetUInt32Elem oder PropVariantGetElem aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propvarutil.h
Bibliothek	Propsys.lib
DLL	Propsys.dll (Version 6.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0