Метод ICLRDebuggingLibraryProvider2::P rovideLibrary2

Статья
03/05/2024

Позволяет отладчику предоставить путь к библиотеке отладки среды CLR для конкретной версии.

Синтаксис

HRESULT ProvideLibrary2 (
     [in] const WCHAR* pwszFileName,
     [in] DWORD dwTimestamp,
     [in] DWORD dwSizeOfImage,
     [out] LPWSTR* ppResolvedModulePath);

Параметры

pwszFilename
[in] Имя запрашиваемого модуля.

dwTimestamp
[in] Метка времени даты, хранящейся в заголовке файла COFF файлов PE.

dwSizeOfImage
[in] SizeOfImage Поле, хранящееся в необязательном заголовке файла PE в COFF.

ppResolvedModulePath
[out] Это путь, завершаемый пустым, в библиотеку dll модуля. В Windows его следует выделить с помощью CoTaskMemAlloc. В Unix его следует выделить с помощью malloc. Неудача оставляет ее нетронутой. См. примечание по безопасности ниже!

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

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

HRESULT	Description
`S_OK`	Метод завершился успешно.

Замечания

ProvideLibrary2 позволяет отладчику предоставлять модули, необходимые для отладки определенных файлов СРЕДЫ CLR, таких как mscordbi.dll и mscordacwks.dll.

Отладчик может использовать любые доступные средства для поиска или приобретения модуля отладки.

Внимание

Эта функция позволяет вызывающей программе API предоставлять модули, содержащие исполняемый файл и, возможно, вредоносный код. В качестве меры предосторожности вызывающий объект не должен использовать ProvideLibrary2 для распространения кода, который не готов выполнить сам.

Если в уже выпущенной библиотеке обнаружена серьезная проблема безопасности, например mscordbi.dll или mscordacwks.dll, исправление может быть исправлено для распознавания плохих версий файлов. Затем схим может выдавать запросы на исправленные версии файлов и отклонять плохие версии, если они предоставлены в ответ на любой запрос. Это может произойти только в том случае, если пользователь исправил новую версию оболочки. Неотреченные версии останутся уязвимыми.

Требования

Платформы: см . поддерживаемые операционные системы .NET.

Заголовок: dbgshim.h

Библиотека: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Версии .NET: доступны с .NET Core 2.1

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