Função FreePropVariantArray (propidl.h)

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

Sintaxe

HRESULT FreePropVariantArray(
  [in]      ULONG       cVariants,
  [in, out] PROPVARIANT *rgvars
);

Parâmetros

[in] cVariants

Tipo: ULONG

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

[in, out] rgvars

Tipo: PROPVARIANT*

Matriz de estruturas PROPVARIANT a serem livres. Quando essa função retorna com êxito, as estruturas PROPVARIANT na matriz são zerados e seu tipo é definido como VT_EMPTY.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

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 ClearPropVariantArray, mas retorna um HRESULT.

Exemplos

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

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

FreePropVariantArray(ARRAYSIZE(rgpropvar), rgpropvar);

Requisitos

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