Поделиться через

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

  • Статья

Освобождает память и ссылки, используемые массивом структур PROPVARIANT .

Синтаксис

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

Параметры

[in] cVariants

Тип: ULONG

Количество элементов в массиве, заданное rgvars.

[in, out] rgvars

Тип: PROPVARIANT*

Массив свободных структур PROPVARIANT . При успешном возвращении этой функции структуры PROPVARIANT в массиве обнуляются, а их тип устанавливается в VT_EMPTY.

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

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Эта функция освобождает память и ссылки, хранящиеся в каждой структуре в массиве, прежде чем устанавливать для структур нулевое значение.

Эта функция выполняет то же действие, что и ClearPropVariantArray, но возвращает HRESULT.

Примеры

В следующем примере, который будет включен в большую программу, показано, как использовать FreePropVariantArray.

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

FreePropVariantArray(ARRAYSIZE(rgpropvar), rgpropvar);

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 с пакетом обновления 1 (SP1) [классические приложения | Приложения UWP]
Целевая платформа Windows
Header propidl.h
Библиотека Ole32.lib
DLL Ole32.dll (версия 6.0 или более поздняя)
Распространяемые компоненты Windows Desktop Search (WDS) 3.0