Share via

Función FreePropVariantArray (combaseapi.h)

  • Artículo

La función FreePropVariantArray llama a PropVariantClear en cada una de las estructuras PROPVARIANT de la matriz rgvars para que el valor sea cero para cada uno de los miembros de la matriz.

Sintaxis

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

Parámetros

[in] cVariants

Recuento de elementos de la matriz PROPVARIANT (rgvars).

[in] rgvars

Puntero a una matriz inicializada de estructuras PROPVARIANT para las que se liberarán los elementos desasignables. Al salir, todos los ceros se escriben en la estructura PROPVARIANT (por lo tanto, se etiquetan como VT_EMPTY).

Valor devuelto

Esta función devuelve HRESULT.

Comentarios

FreePropVariantArray llama a PropVariantClear en una matriz de estructuras PROPVARIANT para borrar todos los miembros válidos. Se liberan todas las estructuras PROPVARIANT válidas. Si alguna de las estructuras PROPVARIANT contiene tipos VT no válidos, se liberan miembros válidos y la función devuelve STG_E_INVALIDPARAMETER.

Pasar NULL para rgvars es legal y genera un código de retorno de S_OK.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado combaseapi.h
Library Ole32.lib
Archivo DLL Ole32.dll

Consulte también

PropVariantClear