Метод IWMDMStorage4::GetSpecifiedMetadata (mswmdm.h)

Статья
02/29/2024

Метод GetSpecifiedMetadata извлекает одно или несколько определенных свойств метаданных из хранилища.

Синтаксис

HRESULT GetSpecifiedMetadata(
  [in]  DWORD         cProperties,
  [in]  LPCWSTR       *ppwszPropNames,
  [out] IWMDMMetaData **ppMetadata
);

Параметры

[in] cProperties

Количество извлекаемых свойств.

[in] ppwszPropNames

Массив извлекаемых имен свойств. Длина этого массива должна быть равна cProperties. Приложение должно освободить эту память с помощью CoTaskMemFree.

[out] ppMetadata

Указатель на возвращенный указатель интерфейса IWMDMMetaData , содержащий полученные значения. Вызывающий объект должен освободить этот интерфейс после завершения работы с ним.

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

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

Стандартные коды ошибок COM
Коды ошибок Windows, преобразованные в значения HRESULT
Коды ошибок диспетчер устройств Windows Media

Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Этот метод предоставляет клиенту контроль над тем, какие свойства извлекаются. Это может быть более эффективным, чем IWMDMStorage3::GetMetadata, и рекомендуется, если клиенту требуется только подмножество свойств, поддерживаемых хранилищем.

Если этот метод используется для получения данных с устройства Windows Portable Devices (WPD), данные возвращаются в двоичной форме в объекте IPortableDeviceValues . Чтобы получить фактические значения свойств, приложение должно десериализовать эти данные.

Метод выполняется успешно и возвращает WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED даже если некоторые из указанных свойств не удалось получить (но было получено хотя бы одно свойство). Метод завершается сбоем и возвращает WMDM_E_NOTSUPPORTED, если не удалось получить ни одно из указанных свойств.

Запрос одного свойства является особым случаем этого метода. Если клиент запрашивает одно свойство, возможные коды возврата S_OK, E_INVALIDARG и WMDM_E_NOTSUPPORTED. Таким образом, в случае с одним свойством метод завершается успешно, только если свойство успешно извлечено.