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

Статья
08/25/2023

Извлекает свойства, указанные в таблице свойств , из базы данных кластера , и возвращает их в списке свойств. Тип PRESUTIL_GET_PROPERTIES определяет указатель на эту функцию.

Синтаксис

DWORD ResUtilGetProperties(
  [in]  HKEY                         hkeyClusterKey,
  [in]  const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out] PVOID                        pOutPropertyList,
  [in]  DWORD                        cbOutPropertyListSize,
  [out] LPDWORD                      pcbBytesReturned,
  [out] LPDWORD                      pcbRequired
);

Параметры

[in] hkeyClusterKey

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

[in] pPropertyTable

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

[out] pOutPropertyList

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

[in] cbOutPropertyListSize

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

[out] pcbBytesReturned

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

[out] pcbRequired

Указатель на количество байтов, которое требуется, если pOutPropertyList слишком мал.

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

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

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

Код возврата	Описание
ERROR_BAD_ARGUMENTS	Один или несколько входных параметров были недопустимы.
ERROR_MORE_DATA	Выходной буфер был слишком мал, чтобы содержать полученные данные. Параметр pcbRequired указывает необходимый размер.
ERROR_NOT_ENOUGH_MEMORY	Произошла ошибка при выделении памяти.

Требования


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

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

ResUtilGetPrivateProperties

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