Função ClearPropVariantArray (propvarutil.h)

Libera a memória e as referências usadas por uma matriz de estruturas PROPVARIANT armazenadas em uma matriz.

Sintaxe

PSSTDAPI_(void) ClearPropVariantArray(
  [in] PROPVARIANT *rgPropVar,
  [in] UINT        cVars
);

Parâmetros

[in] rgPropVar

Tipo: PROPVARIANT*

Matriz de estruturas PROPVARIANT a serem livres.

[in] cVars

Tipo: UINT

O número de elementos na matriz especificada por rgPropVar.

Retornar valor

Sem valor de retorno.

Comentários

Essa função libera a memória e as referências mantidas por cada estrutura na matriz antes de definir as estruturas como zero.

Essa função executa a mesma ação que FreePropVariantArray, mas FreePropVariantArray retorna um HRESULT.

Exemplos

O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar ClearPropVariantArray

// PROPVARIANT rgpropvar[5];
// Assume all 5 propvariants are initialized and valid.

ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));

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

Confira também

ClearVariantArray