Función PropVariantGetElementCount (propvarutil.h)

Recupera el recuento de elementos de una estructura PROPVARIANT .

Sintaxis

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

Parámetros

[in] propvar

Tipo: REFPROPVARIANT

Referencia a la estructura PROPVARIANT de origen.

Valor devuelto

Tipo: ULONG

Devuelve el recuento de elementos de un valor de VT_VECTOR o VT_ARRAY: para valores únicos, devuelve 1; para estructuras vacías, devuelve 0.

Comentarios

Esta función funciona para todos los tipos PROPVARIANT válidos. Consulte PROPVARIANT para ver las combinaciones de tipos válidas.

Esta función es útil para obtener el recuento de elementos para recorrer en iteración mediante una instrucción de bucle, especialmente para las iteraciones que llaman a funciones como PropVariantGetUInt32Elem o PropVariantGetElem.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	propvarutil.h
Library	Propsys.lib
Archivo DLL	Propsys.dll (versión 6.0 o posterior)
Redistribuible	Búsqueda de escritorio de Windows (WDS) 3.0