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

Статья
08/25/2023

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

Синтаксис

DWORD ResUtilFindExpandedSzProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPWSTR      *pszPropertyValue
);

Параметры

[in] pPropertyList

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

[in] cbPropertyListSize

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

[in] pszPropertyName

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

[out, optional] pszPropertyValue

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

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

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

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

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

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

Требования

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