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

Статья
03/15/2023

Извлекает текущий путь относительно корневого блока метаданных.

Синтаксис

HRESULT GetLocation(
  [in]      UINT  cchMaxLength,
  [in, out] WCHAR *wzNamespace,
  [out]     UINT  *pcchActualLength
);

Параметры

[in] cchMaxLength

Тип: UINT

Длина буфера wzNamespace .

[in, out] wzNamespace

Тип: WCHAR*

Указатель, получающий текущее расположение пространства имен.

[out] pcchActualLength

Тип: UINT*

Фактическая длина буфера, необходимая для получения текущего расположения пространства имен.

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

Тип: HRESULT

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

Если передать значение NULLв wzNamespace, GetLocation игнорирует cchMaxLength и возвращает необходимую длину буфера для хранения пути в переменной, на которую указывает pcchActualLength .

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

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

Требования


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

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

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

IWICMetadataQueryReader

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

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

Share via