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

Статья
03/05/2024

Использует таблицу свойств для проверки правильности форматирования списка свойств .

Синтаксис

DWORD ResUtilVerifyPropertyTable(
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
                  PVOID                        Reserved,
  [in]            BOOL                         bAllowUnknownProperties,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [out, optional] LPBYTE                       pOutParams
);

Параметры

[in] pPropertyTable

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

Reserved

Этот параметр зарезервирован для использования в будущем.

[in] bAllowUnknownProperties

Если значение РАВНО TRUE, функция игнорирует все свойства в списке свойств, которые не включены в таблицу свойств. Если значение РАВНО FALSE, любое свойство в списке свойств, не включенное в таблицу свойств, приводит к тому, что функция возвращает ERROR_INVALID_PARAMETER.

[in] pInPropertyList

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

[in] cbInPropertyListSize

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

[out, optional] pOutParams

Указатель на блок параметров.

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

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

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

Код возврата	Описание
ERROR_INSUFFICIENT_BUFFER	Буфер списка свойств больше, чем указано параметром cbInPropertyListSize .
ERROR_INVALID_DATA	Буфер списка свойств не указан или список свойств отформатирован неправильно
ERROR_INVALID_PARAMETER	Список свойств отформатирован неправильно. Если параметр bAllowUnknownProperties имеет значение FALSE, список свойств может содержать свойства, отсутствуют в таблице свойств.

Требования

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

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

RESUTIL_PROPERTY_ITEM

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