FreePropVariantArray
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
PropVariantClear chama essa função em cada uma das estruturas de PROPVARIANT na rgvars matriz para tornar o valor zero para cada um dos membros da matriz.
Syntax
WINOLEAPI FreePropVariantArray(
ULONG cVariants,
PROPVARIANT* rgvars
);
Parameters
- cVariants
[no] Contagem dos Elementos (matriz de PROPVARIANTrgvars).
- rgvars
[no] Ponteiro para uma matriz inicializada de PROPVARIANT estruturas para que quaisquer elementos deallocatable devem ser liberado. Em sair, todos os zeros são gravados a PROPVARIANT estrutura (assim indicação-los como VT_EMPTY).
Valores Return
A seguinte tabela mostra os valores de retorno para esta função.
| Valor | Descrição |
|---|---|
S_OK |
A variante tipos são reconhecidos e todos os itens que podem ser liberados tiverem sido liberados. |
STG_E_INVALID_PARAMETER |
Um ou mais PROPVARIANT Estruturas tem um tipo desconhecido. |
Remarks
FreePropVariantArray Chamadas PropVariantClear Em uma matriz de PROPVARIANT estruturas para Clear todos o válido membros. Todos os válido PROPVARIANT estruturas são liberadas. Se algum do PROPVARIANT Estruturas contêm ilegal VT tipos, válido membros são liberados e a função retorna STG_E_INVALIDPARAMETER.
Passando NULL para rgvars é legal e produz um código de retorno de S_OK.
Requirements
| Header | oaidl.h |
| Library | oleaut32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |