Função FreePropVariantArray (combaseapi.h)

A função FreePropVariantArray chama PropVariantClear em cada uma das estruturas PROPVARIANT na matriz rgvars para tornar o valor zero para cada um dos membros da matriz.

Sintaxe

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

Parâmetros

[in] cVariants

Contagem de elementos na matriz PROPVARIANT (rgvars).

[in] rgvars

Ponteiro para uma matriz inicializada de estruturas PROPVARIANT para as quais todos os elementos desalocantes devem ser liberados. Na saída, todos os zeros são gravados na estrutura PROPVARIANT (marcando-os como VT_EMPTY).

Retornar valor

Essa função retorna HRESULT.

Comentários

FreePropVariantArray chama PropVariantClear em uma matriz de estruturas PROPVARIANT para limpar todos os membros válidos. Todas as estruturas PROPVARIANT válidas são liberadas. Se qualquer uma das estruturas PROPVARIANT contiver tipos VT ilegais, os membros válidos serão liberados e a função retornará STG_E_INVALIDPARAMETER.

Passar NULL para rgvars é legal e produz um código de retorno de S_OK.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	combaseapi.h
Biblioteca	Ole32.lib
DLL	Ole32.dll

Confira também

PropVariantClear