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

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

  • Статья

Возвращает список свойств , включающий все свойства по умолчанию и неизвестные свойства для объекта кластера. Тип PRESUTIL_GET_ALL_PROPERTIES определяет указатель на эту функцию.

Синтаксис

DWORD ResUtilGetAllProperties(
  [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

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

[out] pcbBytesReturned

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

[out] pcbRequired

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

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

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

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

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

Комментарии

Служебная функция ResUtilGetAllProperties делает запись в списке свойств для каждого свойства:

Требования

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

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

RESUTIL_PROPERTY_ITEM