Метод ICorDebugMetaDataLocator::GetMetaData

Статья
11/05/2024

Запрашивает у отладчика возврат полного пути к модулю, метаданные которого необходимы для завершения запрошенной отладчиком операции.

Синтаксис

HRESULT GetMetaData(
      [in] LPCWSTR wszImagePath,
      [in] DWORD   dwImageTimeStamp,
      [in] DWORD   dwImageSize,
      [in] ULONG32 cchPathBuffer,
      [out] ULONG32 * pcchPathBuffer,
      [out, size_is(cchPathBuffer), length_is(*pcchPathBuffer)]
               WCHAR wszPathBuffer[]
      );

Параметры

wszImagePath [in] Строка, завершающаяся значением NULL, представляющая полный путь к файлу. Если полный путь недоступен, имя и расширение файла (имя файла).расширение).

dwImageTimeStamp [in] Метка времени из заголовков PE-файла изображения. Этот параметр может использоваться для поиска сервера символов (SymSrv).

dwImageSize [in] Размер изображения из заголовков PE-файла. Этот параметр может использоваться для поиска SymSrv.

cchPathBuffer [in] Число символов в wszPathBuffer.

pcchPathBuffer [out] WCHARКоличество записываемых записей wszPathBuffer.

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

wszPathBuffer [out] Указатель на буфер, в который отладчик скопирует полный путь к файлу, который содержит запрошенные метаданные.

Флаг ofReadOnly перечисления CorOpenFlags используется для запроса доступа только для чтения к метаданным в этом файле.

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

Этот метод возвращает следующие конкретные результаты HRESULT, а также ошибки HRESULT, которые указывают на сбой метода. Все остальные ошибочные значения HRESULT указывают, что файл не удается найти.

HRESULT Description

S_OK Метод завершился успешно. wszPathBuffer содержит полный путь к файлу и завершается нулевым байтом.

E_NOT_SUFFICIENT_BUFFER Текущий размер wszPathBuffer недостаточен для хранения полного пути. В этом случае pcchPathBuffer содержит необходимое количество WCHAR, включая завершающий символ null, и GetMetaData вызывается второй раз с запрошенным размером буфера.

HRESULT	Description
S_OK	Метод завершился успешно. `wszPathBuffer` содержит полный путь к файлу и завершается нулевым байтом.
E_NOT_SUFFICIENT_BUFFER	Текущий размер `wszPathBuffer` недостаточен для хранения полного пути. В этом случае `pcchPathBuffer` содержит необходимое количество `WCHAR`, включая завершающий символ null, и `GetMetaData` вызывается второй раз с запрошенным размером буфера.

Замечания

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

Требования

Платформы: см. раздел Требования к системе.

Заголовок: CorDebug.idl, CorDebug.h

Библиотека: CorGuids.lib

версии платформа .NET Framework: Доступно с 4

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