Função PropVariantGetElementCount (propvarutil.h)

Recupera a contagem de elementos de uma estrutura PROPVARIANT .

Sintaxe

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

Parâmetros

[in] propvar

Tipo: REFPROPVARIANT

Referência à estrutura PROPVARIANT de origem.

Retornar valor

Tipo: ULONG

Retorna a contagem de elementos de um valor de VT_VECTOR ou VT_ARRAY: para valores únicos, retorna 1; para estruturas vazias, retorna 0.

Comentários

Essa função funciona para todos os tipos PROPVARIANT válidos. Consulte PROPVARIANT para obter as combinações de tipo válidas.

Essa função é útil para obter a contagem de elementos para iterar usando uma instrução de looping, especialmente para iterações que chamam funções como PropVariantGetUInt32Elem ou PropVariantGetElem.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	propvarutil.h
Biblioteca	Propsys.lib
DLL	Propsys.dll (versão 6.0 ou posterior)
Redistribuível	Pesquisa da Área de Trabalho do Windows (WDS) 3.0