функция PSPropertyBag_ReadStrAlloc (propsys.h)

Считывает строковое значение данных из свойства в контейнере свойств и выделяет память для считываемой строки.

Синтаксис

PSSTDAPI PSPropertyBag_ReadStrAlloc(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] PWSTR        *value
);

Параметры

[in] propBag

Тип: IPropertyBag*

Указатель на объект IPropertyBag , представляющий контейнер свойств, в котором хранится свойство.

[in] propName

Тип: LPCWSTR

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

[out] value

Тип: PWSTR*

При возврате этой функции содержит указатель на значение строковых данных из свойства в контейнере свойств и выделяет память для считываемой строки. Вызывающий объект функции PSPropertyBag_ReadStrAlloc должен вызвать функцию CoTaskMemFree для этого параметра.

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

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

API функции свойств контейнера свойств преобразует типы окон в тип VARIANT , который используется для выражения значений в контейнере свойств. Это упрощает использование контейнера свойств, упрощает приложения и позволяет избежать распространенных ошибок кода.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	propsys.h
Библиотека	Propsys.lib
DLL	Propsys.dll (версия 6.0 или более поздняя)