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

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

  • Статья

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

Синтаксис

DWORD ResUtilSetPropertyParameterBlockEx(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [in]            PVOID                        Reserved,
  [in]            const LPBYTE                 pInParams,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [in]            BOOL                         bForceWrite,
  [out, optional] LPBYTE                       pOutParams
);

Параметры

[in] hkeyClusterKey

Ключ базы данных кластера, определяющий расположение для заданных свойств.

[in] pPropertyTable

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

[in] Reserved

Зарезервировано.

[in] pInParams

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

[in] pInPropertyList

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

[in] cbInPropertyListSize

Размер входного буфера в байтах, на который указывает pInPropertyList.

[in] bForceWrite

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

[out, optional] pOutParams

Указатель на блок параметров для получения данных, скопированных из параметра pInParams .

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

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

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

Код возврата Описание
ERROR_INVALID_PARAMETER
 Синтаксис, формат или тип свойства в таблице свойств, на которую указывает pPropertyTable , неправильный, или свойство доступно только для чтения и не может быть обновлено.
ERROR_BAD_ARGUMENTS
 Один или несколько входных параметров были недопустимыми.

Комментарии

Не вызывайте ResUtilSetPropertyParameterBlockEx из следующих функций точки входа dll ресурсов:

ResUtilSetPropertyParameterBlockEx можно безопасно вызывать из любой другой функции точки входа DLL ресурсов или из рабочего потока. Дополнительные сведения см. в разделе Вызовы функций, которые следует избегать в библиотеках DLL ресурсов.

Требования

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

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

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyParameterBlock