Функция ClearPropVariantArray (propvarutil.h)

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

Синтаксис

PSSTDAPI_(void) ClearPropVariantArray(
  [in] PROPVARIANT *rgPropVar,
  [in] UINT        cVars
);

Параметры

[in] rgPropVar

Тип: PROPVARIANT*

Массив свободных структур PROPVARIANT .

[in] cVars

Тип: UINT

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

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

Нет возвращаемого значения.

Комментарии

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

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

Примеры

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

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

ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));

Требования

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

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

ClearVariantArray