ICLRDebuggingLibraryProvider::ProvideLibrary – metoda
Získá rozhraní zpětného volání zprostředkovatele knihovny, které umožňuje common language runtime (CLR) verze ladicí knihovny na vyžádání a načíst.
Syntaxe
HRESULT ProvideLibrary(
[in] const WCHAR* pwszFileName,
[in] DWORD dwTimestamp,
[in] DWORD dwSizeOfImage,
[out] HMODULE* hModule);
Parametry
pwszFilename
[v] Název požadovaného modulu.
dwTimestamp
[v] Časové razítko uložené v hlavičce souboru COFF souborů PE.
dwSizeOfImage
[v] Pole SizeOfImage uložené v hlavičce volitelného souboru COFF souborů PE.
hModule
[out] Popisovač požadovaného modulu
Návratová hodnota
Tato metoda vrátí následující konkrétní hodnoty HRESULT a také chyby HRESULT, které značí selhání metody.
| HRESULT | Description |
|---|---|
| S_OK | Metoda byla úspěšně dokončena. |
Výjimky
Poznámky
ProvideLibrary umožňuje ladicímu programu poskytovat moduly potřebné pro ladění konkrétních souborů CLR, jako jsou mscordbi.dll a mscordacwks.dll. Popisovače modulu musí zůstat platné, dokud volání metody ICLRDebugging::CanUnloadNow indikuje, že mohou být uvolněny, v tomto okamžiku je volající zodpovědný za uvolnění popisovačů.
Ladicí program může použít jakékoli dostupné prostředky k vyhledání nebo obstarání 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. Z bezpečnostních důvodů by volající neměl používat ProvideLibrary k distribuci kódu, který není ochotný sám spustit.
Pokud se v již vydané knihovně zjistí závažný problém se zabezpečením, jako je mscordbi.dll nebo mscordacwks.dll, je možné přešírování opravit, aby rozpoznalo chybné verze souborů. Shim pak může vydávat požadavky na opravené verze souborů a odmítnout chybné verze, pokud jsou poskytnuty v reakci na jakýkoli požadavek. K tomu může dojít pouze v případě, že uživatel má opravu na novou verzi vysypávačky. Neopravené verze zůstanou zranitelné.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: CorDebug.idl, CorDebug.h
Knihovny: CorGuids.lib
Verze rozhraní .NET Framework: K dispozici od 4
