Função ClearPropVariantArray (propvarutil.h)
Libera a memória e as referências usadas por uma matriz de estruturas PROPVARIANT armazenadas em uma matriz.
Sintaxe
PSSTDAPI_(void) ClearPropVariantArray(
[in] PROPVARIANT *rgPropVar,
[in] UINT cVars
);
Parâmetros
[in] rgPropVar
Tipo: PROPVARIANT*
Matriz de estruturas PROPVARIANT a serem livres.
[in] cVars
Tipo: UINT
O número de elementos na matriz especificada por rgPropVar.
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.
Essa função executa a mesma ação que FreePropVariantArray, mas FreePropVariantArray retorna um HRESULT.
Exemplos
O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar ClearPropVariantArray
// PROPVARIANT rgpropvar[5];
// Assume all 5 propvariants are initialized and valid.
ClearPropVariantArray(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 |