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

Consulte también

ClearVariantArray