Compartilhar via


Função ClearVariantArray (propvarutil.h)

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

Sintaxe

PSSTDAPI_(void) ClearVariantArray(
  [in] VARIANT *pvars,
  [in] UINT    cvars
);

Parâmetros

[in] pvars

Tipo: VARIANT*

Matriz de estruturas VARIANT a serem gratuitas.

[in] cvars

Tipo: UINT

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

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.

Exemplos

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

// VARIANT rgpropvar[5];
// Assume all 5 variants are initialized and valid.

ClearVariantArray(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

ClearPropVariantArray

FreePropVariantArray