Share via

Метод ICorDebugMetaDataLocator::GetMetaData

  • Статья

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

Синтаксис

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] Завершающаяся нулевым байтом строка, представляющая полный путь к файлу. Если полный путь недоступен, имя и расширение файла (имя файла. extension).

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 Описание:
S_OK Метод завершился успешно. wszPathBuffer содержит полный путь к файлу и завершается нулевым байтом.
E_NOT_SUFFICIENT_BUFFER Текущий размер wszPathBuffer недостаточен для хранения полного пути. В этом случае pcchPathBuffer содержит необходимое количество WCHAR, включая завершающий символ null, и GetMetaData вызывается второй раз с запрошенным размером буфера.

Комментарии

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

Требования

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

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

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

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

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