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


Метод IWMDMMetaData::QueryByIndex (mswmdm.h)

Метод QueryByIndex извлекает значение свойства, указанного индексом.

Синтаксис

HRESULT QueryByIndex(
  [in]  UINT              iIndex,
  [out] WCHAR             **ppwszName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **ppValue,
  [out] UINT              *pcbLength
);

Параметры

[in] iIndex

Целое число, указывающее отсчитываемый от нуля индекс свойства. Количество элементов получается с помощью вызова GetItemCount .

[out] ppwszName

Имя свойства. Windows Media диспетчер устройств выделяет эту память, и вызывающий объект должен освободить ее с помощью CoTaskMemFree.

[out] pType

WMDM_TAG_DATATYPE перечислимое значение, описывающее тип данных, возвращаемых в ppValue.

[out] ppValue

Указатель на указатель на массив байтов, который получает содержимое значения при успешном выполнении метода. Эта память выделяется windows Media диспетчер устройств, и вызывающий объект должен освободить ее с помощью CoTaskMemFree.

[out] pcbLength

Указатель на размер массива байтов ppValue (в байтах). Если значение является строкой, это включает символ завершения.

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

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

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

Требования

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

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

GetItemCount

Интерфейс IWMDMMetaData

QueryByName

Настройка метаданных для файла