Función ClearPropVariantArray (propvarutil.h)
Libera la memoria y las referencias usadas por una matriz de estructuras PROPVARIANT almacenadas en una matriz.
Sintaxis
PSSTDAPI_(void) ClearPropVariantArray(
[in] PROPVARIANT *rgPropVar,
[in] UINT cVars
);
Parámetros
[in] rgPropVar
Tipo: PROPVARIANT*
Matriz de estructuras PROPVARIANT que se liberarán.
[in] cVars
Tipo: UINT
Número de elementos de la matriz especificada por rgPropVar.
Valor devuelto
No de devuelve ningún valor.
Comentarios
Esta función libera la memoria y las referencias que mantiene cada estructura de la matriz antes de establecer las estructuras en cero.
Esta función realiza la misma acción que FreePropVariantArray, pero FreePropVariantArray devuelve un HRESULT.
Ejemplos
En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar ClearPropVariantArray.
// PROPVARIANT rgpropvar[5];
// Assume all 5 propvariants are initialized and valid.
ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | propvarutil.h |
| Library | Propsys.lib |
| Archivo DLL | Propsys.dll (versión 6.0 o posterior) |
| Redistribuible | Búsqueda de escritorio de Windows (WDS) 3.0 |