Función FreePropVariantArray (combaseapi.h)
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 |