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

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

  • Статья

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

Синтаксис

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

Параметры

[in] hkeyClusterKey

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

[in] pPropertyTable

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

[in] Reserved

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

[in] pInParams

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

[in] pInPropertyList

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

[in] cbInPropertyListSize

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

[out, optional] pOutParams

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

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

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

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

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

Комментарии

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

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

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

Требования

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

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

RESUTIL_PROPERTY_ITEM