Поделиться через

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

  • Статья

Метод GetSpecifiedMetadata извлекает только указанный объект метаданных для хранилища.

Синтаксис

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

Параметры

[in] cProperties

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

[in] ppwszPropNames

Массив, содержащий имена извлекаемого свойства. Размер этого массива должен быть равен cProperties.

[out] pMetadata

Указатель на возвращенный указатель интерфейса IWMDMMetaData .

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

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

  • Стандартные коды ошибок COM
  • Коды ошибок Windows, преобразованные в значения HRESULT
  • Коды ошибок диспетчер устройств Windows Media
Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Комментарии

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

Напротив, метод GetMetadata извлекает все метаданные хранилища (свойства).

Если ни одно из указанных свойств не может быть возвращено, поставщик услуг должен вернуть WMDM_E_NOTSUPPORTED или любой подходящий код ошибки.

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

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

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

Интерфейс IMDSPStorage4