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

Статья
03/08/2023

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

Синтаксис

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

Параметры

[in] pPropertyList

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

[in] cbPropertyListSize

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

[in] pszPropertyName

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

[out, optional] pszPropertyValue

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

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

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

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

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

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

Требования


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