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

Статья
08/25/2023

Находит указанное двоичное свойство в списке свойств и может также возвращать значение свойства. Тип PRESUTIL_FIND_BINARY_PROPERTY определяет указатель на эту функцию.

Синтаксис

DWORD ResUtilFindBinaryProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPBYTE      *pbPropertyValue,
  [out, optional] LPDWORD     pcbPropertyValueSize
);

Параметры

[in] pPropertyList

Указатель на список свойств, в котором нужно найти значение.

[in] cbPropertyListSize

Размер (в байтах) списка свойств, заданного pPropertyList.

[in] pszPropertyName

Указатель на строку Юникода, завершающуюся null, которая содержит имя искать свойство.

[out, optional] pbPropertyValue

Указатель на указатель BYTE на буфер (выделенный функцией), содержащий копию значения свойства. Чтобы освободить выделенную память, необходимо вызвать метод LocalFree (в *pbPropertyValue). Если значение не требуется, передайте значение NULL для этого параметра.

[out, optional] pcbPropertyValueSize

Указатель на размер возвращаемого значения в байтах. Если размер не требуется, передайте значение NULL для этого параметра.

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

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

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

Код возврата	Описание
ERROR_INVALID_DATA	Список свойств отформатирован неправильно.
ERROR_NOT_ENOUGH_MEMORY	Функции не удалось выделить буфер, в который будет возвращено значение свойства.
ERROR_FILE_NOT_FOUND	Не удалось найти указанное свойство в списке свойств.

Если resUtilFindBinaryProperty выполнен успешно, *pbPropertyValue указывает на копию данных, хранящихся в pPropertyList. Не забудьте вызвать LocalFree для *pbPropertyValue , чтобы предотвратить утечку памяти.

Требования

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