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

Статья
08/25/2023

Извлекает строковое свойство из списка свойств и перемещает указатель на следующее свойство в списке. Тип PRESUTIL_GET_SZ_PROPERTY определяет указатель на эту функцию.

Синтаксис

DWORD ResUtilGetSzProperty(
  [out]          LPWSTR             *ppszOutValue,
  [in]           const PCLUSPROP_SZ pValueStruct,
  [in, optional] LPCWSTR            pszOldValue,
  [in, out]      LPBYTE             *ppPropertyList,
  [in, out]      LPDWORD            pcbPropertyListSize
);

Параметры

[out] ppszOutValue

Адрес указателя, в котором будет возвращено строковое значение из списка свойств.

[in] pValueStruct

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

[in, optional] pszOldValue

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

[in, out] ppPropertyList

Адрес указателя на буфер списка свойств, содержащий строковое свойство. Этот указатель будет передвигаться в начало следующего свойства.

[in, out] pcbPropertyListSize

Указатель на размер буфера списка свойств. Размер будет уменьшен с учетом перехода указателя ppPropertyList .

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

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

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	Данные форматируются неправильно.

Требования


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

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

ResUtilGetBinaryProperty

ResUtilGetDwordProperty

ResUtilGetMultiSzProperty

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