Функция ResUtilAddUnknownProperties (resapi.h)
Извлекает набор неизвестных свойств из базы данных кластера и добавляет их в конец списка свойств.
Синтаксис
DWORD ResUtilAddUnknownProperties(
[in] HKEY hkeyClusterKey,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
[in, out] PVOID pOutPropertyList,
[in] DWORD pcbOutPropertyListSize,
[in, out] LPDWORD pcbBytesReturned,
[in, out] LPDWORD pcbRequired
);
Параметры
[in] hkeyClusterKey
Указатель на ключ базы данных кластера, который определяет расположение для считывания свойств.
[in] pPropertyTable
Указатель на таблицу свойств , описывающую общие и закрытые свойства объекта. Все свойства, обнаруженные в кластерной базе данных, которых нет в этой таблице свойств, добавляются в список свойств.
[in, out] pOutPropertyList
Указатель на буфер, в котором необходимо получить возвращаемые свойства. На входных данных буфер может содержать существующий список свойств или быть пустым. В выходных данных полученные свойства будут добавлены в конец существующего списка или, если буфер пуст, возвращается в виде нового списка свойств.
[in] pcbOutPropertyListSize
Общий размер байтов буфера, на который указывает pOutPropertyList. Размер буфера должен быть достаточно большим, чтобы он содержал существующий список свойств и список возвращаемых свойств.
[in, out] pcbBytesReturned
На входных данных — указатель на размер байтов списка свойств, содержащегося в буфере pOutPropertyList. В выходных данных — указатель на общее количество байтов в списке свойств, на который указывает pOutPropertyList.
[in, out] pcbRequired
В выходных данных указывает на общее количество байтов, необходимых для хранения возвращаемого списка свойств. Если буфер pOutPropertyList был слишком мал, его можно перераспределить до требуемого размера.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.
Если операция завершается сбоем, функция возвращает код системной ошибки. Ниже приведен возможный код ошибки.
| Код возврата | Описание |
|---|---|
|
Произошла ошибка при выделении памяти. |
Комментарии
Связи между входными и выходными параметрами ResUtilAddUnknownProperties показаны на следующей схеме:
Служебная функция ResUtilAddUnknownProperties перечисляет свойства, хранящиеся в базе данных кластера (в разделе hkeyClusterKey), и ищет соответствующие свойства в таблице свойств (pPropertyTable). Каждое свойство, указанное в базе данных кластера, но не указанное в таблице свойств, добавляется в список свойств (pOutPropertyList).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter |
| Целевая платформа | Windows |
| Header | resapi.h |
| Библиотека | ResUtils.lib |
| DLL | ResUtils.dll |