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

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

  • Статья

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

Синтаксис

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

Параметры

[in] hkeyClusterKey

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

[in] pPropertyTable

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

Reserved

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

[in] bAllowUnknownProperties

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

[in] pInPropertyList

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

[in] cbInPropertyListSize

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

[out, optional] pOutParams

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

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

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

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

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

Комментарии

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

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

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

Требования

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

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

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyTableEx