Метод IPropertyStorage::ReadPropertyNames (propidlbase.h)
Метод ReadPropertyNames извлекает все существующие строковые имена для указанных идентификаторов свойств.
Синтаксис
HRESULT ReadPropertyNames(
[in] ULONG cpropid,
[in] const PROPID [] rgpropid,
[in, out] LPOLESTR [] rglpwstrName
);
Параметры
[in] cpropid
Количество элементов во входных данных массива rgpropid. Значение этого параметра может быть равно нулю, однако это не позволяет выполнить назначение этого метода, так как таким образом имена свойств не считываются.
[in] rgpropid
Массив идентификаторов свойств, для которых требуется извлечь имена.
[in, out] rglpwstrName
Выделенный вызывающим объектом массив размера cpropid членов LPWSTR . При возврате реализация заполняет этот массив. Данная запись содержит либо соответствующее строковое имя идентификатора свойства, либо может быть пустой, если у идентификатора свойства нет строковых имен.
Каждый элемент LPWSTR массива должен быть освобожден с помощью функции CoTaskMemFree .
Возвращаемое значение
Этот метод поддерживает стандартное возвращаемое значение E_UNEXPECTED, а также следующее:
Комментарии
Для каждого идентификатора свойства в списке идентификаторов свойств, предоставленных в массиве rgpropid , ReadPropertyNames получает соответствующее строковое имя, если оно имеется. Строковые имена создаются путем указания имен в вызовах IPropertyStorage::WriteMultiple при создании свойства или путем вызова метода IPropertyStorage::WritePropertyNames. В любом случае имя строки является необязательным, однако все свойства должны иметь идентификатор свойства.
Строковые имена, сопоставленные с идентификаторами свойств, должны быть уникальными в пределах набора.
Требования
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | propidlbase.h (включая Objbase.h, Propidlbase.h) |
| Библиотека | Uuid.lib |
| DLL | Ole32.dll |