Compartilhar via

Função PropVariantGetElementCount (propvarutil.h)

  • Artigo

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