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

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

  • Статья

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

Синтаксис

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

Параметры

[in] hkeyClusterKey

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

[in] pPropertyTable

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

Reserved

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

[in] bAllowUnknownProperties

Указывает, следует ли принимать неизвестные свойства . Этот параметр имеет значение TRUE , если они должны быть приняты, и FALSE , если нет.

[in] pInPropertyList

Указатель на входной буфер, содержащий список свойств.

[in] cbInPropertyListSize

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

[in] bForceWrite

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

[out, optional] pOutParams

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

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

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

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

Код возврата Описание
ERROR_BAD_ARGUMENTS
 Один или несколько входных параметров были недопустимыми.
ERROR_INSUFFICIENT_BUFFER
 Размер входного буфера, указанного в cbInPropertyListSize, слишком мал.
ERROR_INVALID_DATA
 Входной буфер, на который указывает pInPropertyList , имеет значение NULL, недопустимое имя свойства или слишком малое значение свойства.
ERROR_INVALID_PARAMETER
 Синтаксис, формат или тип свойства в таблице свойств, на которую указывает pPropertyTable , неправильный, или свойство доступно только для чтения и не может быть задано.

Комментарии

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

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

Требования

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

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

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyTable