Метод IWICMetadataQueryReader::GetLocation (wincodec.h)
Извлекает текущий путь относительно корневого блока метаданных.
Синтаксис
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 |
См. также раздел
Основные понятия