Метод IWICMetadataQueryReader::GetMetadataByName (wincodec.h)

Извлекает блок метаданных или элемент, идентифицируемый выражением запроса метаданных.

Синтаксис

HRESULT GetMetadataByName(
  [in]      LPCWSTR     wzName,
  [in, out] PROPVARIANT *pvarValue
);

Параметры

[in] wzName

Тип: LPCWSTR

Выражение запроса к запрошенным блоку метаданных или элементу.

[in, out] pvarValue

Тип: PROPVARIANT*

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

GetMetadataByName использует выражения запроса метаданных для доступа к внедренным метаданным. Дополнительные сведения о языке запросов метаданных см. в статье Общие сведения о языке запросов метаданных.

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

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header wincodec.h
Библиотека Windowscodecs.lib
DLL Windowscodecs.dll

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

Основные понятия

IWICMetadataQueryReader

Общие сведения о языке запросов метаданных

Другие ресурсы

Общие сведения о чтении и записи метаданных изображения

PROPVARIANT

Общие сведения о метаданных WIC