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

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

  • Статья

Задает закрытые свойстваобъекта кластера.

Синтаксис

DWORD ResUtilSetPrivatePropertyList(
  [in] HKEY        hkeyClusterKey,
  [in] const PVOID pInPropertyList,
  [in] DWORD       cbInPropertyListSize
);

Параметры

[in] hkeyClusterKey

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

[in] pInPropertyList

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

[in] cbInPropertyListSize

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

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

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

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

Код возврата Описание
ERROR_BAD_ARGUMENTS
 Один или несколько входных параметров были недопустимы.
ERROR_INVALID_DATA
 Возникла проблема с длиной данных свойства.
ERROR_INSUFFICIENT_BUFFER
 Входной буфер, на который указывает pInPropertyList , имеет значение NULL.
ERROR_INVALID_PARAMETER
 Недопустимый синтаксис имени свойства.

Комментарии

Свойства, заданные в служебной функции ResUtilSetPrivatePropertyList , помещаются в часть базы данных кластера под указанным ключом для объекта точно так, как указано в именах в списке свойств. Если имя свойства содержит символы обратной косой черты (\), каждая строка, предшествующая символу обратной косой черты, интерпретируется как имя подраздела, а последняя строка после последнего символа обратной косой черты интерпретируется как имя значения.

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

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

Требования

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

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

ResUtilVerifyPrivatePropertyList