Metoda ICLRDebuggingLibraryProvider2::P rovideLibrary2

Umožňuje ladicímu programu poskytnout cestu k knihovně ladění CLR (Common Language Runtime) specifické pro konkrétní verzi.

Syntaxe

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

Parametry

pwszFilename
[v] Název požadovaného modulu.

dwTimestamp
[v] Časové razítko data uložené v hlavičce souboru COFF souborů PE.

dwSizeOfImage
[v] Pole SizeOfImage uložené v záhlaví volitelného souboru COFF souborů PE.

ppResolvedModulePath
[ven] Jedná se o nulovou ukončenou cestu k knihovně DLL modulu. Ve Windows by se měl přidělit coTaskMemAlloc. Na Unixu by měla být přidělena malloc. Chyba zůstane nedotčená. Podívejte se na poznámku k zabezpečení níže.

Návratová hodnota

Tato metoda vrátí následující konkrétní HRESULT a také chyby HRESULT, které označují selhání metody.

HRESULT	Popis
S_OK	Metoda byla úspěšně dokončena.

Poznámky

ProvideLibrary2 umožňuje ladicí program poskytovat moduly potřebné pro ladění konkrétních souborů CLR, jako jsou mscordbi.dll a mscordacwks.dll.

Ladicí program může použít jakékoli dostupné prostředky k vyhledání nebo pořízení modulu ladění.

Důležité

Tato funkce umožňuje volajícímu rozhraní API poskytovat moduly, které obsahují spustitelný a potenciálně škodlivý kód. Jako bezpečnostní opatření by volající neměl používat ProvideLibrary2 k distribuci jakéhokoli kódu, který není ochotný provést sám.

Pokud je v již vydané knihovně zjištěn závažný problém se zabezpečením, jako je mscordbi.dll nebo mscordacwks.dll, je možné převzorkování opravit, aby rozpoznalo chybné verze souborů. Převráce může pak vydávat požadavky na opravené verze souborů a odmítnout chybné verze, pokud jsou k dispozici v reakci na jakýkoli požadavek. K tomu může dojít pouze v případě, že uživatel opravil novou verzi shimu. Nepatchované verze zůstanou zranitelné.

Požadavky

Platformy: Viz podporované operační systémy .NET.

Hlavička: dbgshim.h

Knihovna: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Verze .NET: K dispozici od .NET Core 2.1