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

Статья
08/25/2023

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

Синтаксис

DWORD ResUtilFindMultiSzProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPWSTR      *pszPropertyValue,
  [out] LPDWORD     pcbPropertyValueSize
);

Параметры

[in] pPropertyList

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

[in] cbPropertyListSize

Размер в байтах данных, включенных в pPropertyList.

[in] pszPropertyName

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

[out] pszPropertyValue

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

[out] pcbPropertyValueSize

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

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

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

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

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

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

Требования

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