Функция 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 |