Метод IPropertyStorage::ReadMultiple (propidl.h)

Статья
03/01/2024

Метод ReadMultiple считывает указанные свойства из текущего набора свойств.

Синтаксис

HRESULT ReadMultiple(
  [in]  ULONG             cpspec,
  [in]  const PROPSPEC [] rgpspec,
  [out] PROPVARIANT []    rgpropvar
);

Параметры

[in] cpspec

Числовое число свойств, указываемых в массиве rgpspec . Значение этого параметра можно задать равным нулю; однако это не позволяет использовать назначение метода, так как никакие свойства не считываются, независимо от значений, заданных в rgpspec.

[in] rgpspec

Массив структур PROPSPEC указывает, какие свойства считываются. Свойства можно указать либо идентификатором свойства, либо необязательным строковым именем. Нет необходимости указывать свойства в определенном порядке в массиве. Массив может содержать повторяющиеся свойства, что приводит к повторяющимся значениям свойств при возврате для простых свойств. Свойства nonsimple должны возвращать доступ, запрещенный при попытке открыть их во второй раз. Массив может содержать сочетание идентификаторов свойств и строк.

[out] rgpropvar

Выделенный вызывающей стороной массив структуры PROPVARIANT , который при возврате содержит значения свойств, заданных соответствующими элементами в массиве rgpspec . Массив должен быть по крайней мере достаточно большим для хранения значений параметра cpspec структуры PROPVARIANT . Параметр cpspec указывает количество свойств, заданных в массиве. Вызывающий объект не обязан инициализировать эти значения структуры PROPVARIANT в определенном порядке. Однако реализация должна правильно заполнить все члены при возврате. Если другое подходящее значение отсутствует, реализация должна задать для элемента vt каждой структуры PROPVARIANTзначение VT_EMPTY.

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

Этот метод поддерживает стандартное возвращаемое значение E_UNEXPECTED, а также следующее:

Эта функция также может возвращать любые ошибки файловой системы или ошибки Win32, заключенные в тип данных HRESULT . Дополнительные сведения см. в разделе Стратегии обработки ошибок.

Дополнительные сведения см. в разделе Рекомендации по хранилищу свойств.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	propidl.h (включая Objbase.h, Propidlbase.h)
Библиотека	Uuid.lib
DLL	Ole32.dll