Función FreePropVariantArray (propidl.h)

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