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


Функция ResUtilDupParameterBlock (resapi.h)

Выполняет копирование данных на основе элементов из одного блока параметров в другой.

Синтаксис

DWORD ResUtilDupParameterBlock(
  [out] LPBYTE                       pOutParams,
  [in]  const LPBYTE                 pInParams,
  [in]  const PRESUTIL_PROPERTY_ITEM pPropertyTable
);

Параметры

[out] pOutParams

Указатель на повторяющийся блок параметров.

[in] pInParams

Указатель на исходный блок параметров.

[in] pPropertyTable

Указатель на массив RESUTIL_PROPERTY_ITEM структур, описывающих свойства в исходном блоке параметров.

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

Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.

Если операция завершается сбоем, функция возвращает код системной ошибки.

Комментарии

ResUtilDupParameterBlock копирует данные только для элементов блока параметров, на которые ссылается входной параметр pPropertyTable . Если переменная в блоке входных параметров является указателем, память для данных выделяется с помощью функции LocalAlloc. Вы должны освободить эту память, вызвав LocalFree для каждой переменной указателя в блоке выходных параметров или ResUtilFreeParameterBlock. Убедитесь, что вы освобождаете память независимо от того, успешно ли выполняется resUtilDupParameterBlock . Дополнительные сведения см. в разделах Использование блоков параметров и Использование Списки и таблиц.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter
Целевая платформа Windows
Header resapi.h
Библиотека ResUtils.lib
DLL ResUtils.dll

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

RESUTIL_PROPERTY_ITEM

ResUtilFreeParameterBlock