ICLRDebuggingLibraryProvider3::P rovideWindowsLibrary – metoda

Získá rozhraní zpětného volání zprostředkovatele knihovny, které umožňuje knihovny ladění specifické pro jazyk CLR (Common Language Runtime) umístěné a načtené na vyžádání.

Syntaxe

HRESULT ProvideWindowsLibrary (
     [in] const WCHAR* pwszFileName,
     [in] const WCHAR* pwszRuntimeModule,
     [in] LIBRARY_PROVIDER_INDEX_TYPE indexType,
     [in] DWORD dwTimestamp,
     [in] DWORD dwSizeOfImage,
     [out] LPWSTR* ppResolvedModulePath);

Parametry

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

pwszRuntimeModule
[v] Cesta modulu runtime nebo modulu s jedním souborem.

indexType
[v] Zadaný typ informací o indexu (dwTimestamp/dwSizeOfImage). Viz LIBRARY_PROVIDER_INDEX_TYPE výčtu.

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

ProvideWindowsLibrary 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 ProvideWindowsLibrary 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