Метод 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

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

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames