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

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

  • Статья

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

Синтаксис

DWORD ResUtilGetPropertiesToParameterBlock(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out]           LPBYTE                       pOutParams,
  [in]            BOOL                         bCheckForRequiredProperties,
  [out, optional] LPWSTR                       *pszNameOfPropInError
);

Параметры

[in] hkeyClusterKey

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

[in] pPropertyTable

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

[out] pOutParams

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

[in] bCheckForRequiredProperties

Указывает, должна ли возникать ошибка, если отсутствуют необходимые свойства.

[out, optional] pszNameOfPropInError

Адрес строкового указателя, в котором возвращается имя ошибки, созданной отсутствующим обязательным свойством. Свойство ppszNameOfPropInError является необязательным.

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

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

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

Код возврата Описание
ERROR_BAD_ARGUMENTS
 Один или несколько входных параметров были недопустимы.
ERROR_NOT_ENOUGH_MEMORY
 Произошла ошибка при выделении памяти.

Комментарии

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

Требования

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

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

RESUTIL_PROPERTY_ITEM