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 |