Compartir a través de

Función FreePropVariantArray (propidl.h)

  • Artículo

Libera la memoria y las referencias utilizadas por una matriz de estructuras PROPVARIANT .

Sintaxis

HRESULT FreePropVariantArray(
  [in]      ULONG       cVariants,
  [in, out] PROPVARIANT *rgvars
);

Parámetros

[in] cVariants

Tipo: ULONG

Número de elementos de la matriz especificada por rgvars.

[in, out] rgvars

Tipo: PROPVARIANT*

Matriz de estructuras PROPVARIANT que se van a liberar. Cuando esta función se devuelve correctamente, las estructuras PROPVARIANT de la matriz están en cero y su tipo se establece en VT_EMPTY.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

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 ClearPropVariantArray, pero devuelve un HRESULT.

Ejemplos

En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar FreePropVariantArray

// PROPVARIANT rgpropvar[5];
// Assume all 5 propvariants are initialized and valid.

FreePropVariantArray(ARRAYSIZE(rgpropvar), rgpropvar);

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 con SP1 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado propidl.h
Library Ole32.lib
Archivo DLL Ole32.dll (versión 6.0 o posterior)
Redistribuible Windows Desktop Search (WDS) 3.0