Функция FreePropVariantArray (combaseapi.h)

Функция FreePropVariantArray вызывает PropVariantClear для каждой структуры PROPVARIANT в массиве rgvars , чтобы сделать нулевое значение для каждого из элементов массива.

Синтаксис

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

Параметры

[in] cVariants

Количество элементов в массиве PROPVARIANT (rgvars).

[in] rgvars

Указатель на инициализированный массив структур PROPVARIANT , для которых должны быть освобождены все освобожденные элементы. При выходе все нули записываются в структуру PROPVARIANT (таким образом, помечая их как VT_EMPTY).

Возвращаемое значение

Эта функция возвращает HRESULT.

Комментарии

FreePropVariantArray вызывает PropVariantClear для массива структур PROPVARIANT , чтобы очистить все допустимые элементы. Все допустимые структуры PROPVARIANT освобождаются. Если какая-либо из структур PROPVARIANT содержит недопустимые типы VT, допустимые члены освобождаются, а функция возвращает STG_E_INVALIDPARAMETER.

Передача NULL для rgvars является допустимой и создает код возврата S_OK.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	combaseapi.h
Библиотека	Ole32.lib
DLL	Ole32.dll

См. также раздел

PropVariantClear