ICLRDebuggingLibraryProvider::P rovideLibrary metódus

Lekéri a kódtárszolgáltató visszahívási felületét, amely lehetővé teszi a közös nyelvi futtatókörnyezeti (CLR) verzióspecifikus hibakeresési kódtárak igény szerinti elhelyezését és betöltését.

Szintaxis

HRESULT ProvideLibrary(
     [in] const WCHAR* pwszFileName,
     [in] DWORD dwTimestamp,
     [in] DWORD dwSizeOfImage,
     [out] HMODULE* hModule);

Paraméterek

pwszFilename
[in] A kért modul neve.

dwTimestamp
[in] A PE-fájlok COFF-fájlfejlécében tárolt dátum-időbélyeg.

dwSizeOfImage
[in] A SizeOfImage PE-fájlok COFF opcionális fájlfejlécében tárolt mező.

hModule
[kifelé] A kért modul leírója.

Visszatérési érték

Ez a metódus a következő konkrét HRESULT-okat, valamint a metódushibát jelző HRESULT-hibákat adja vissza.

HRESULT	Description
S_OK	A metódus sikeresen befejeződött.

Kivételek

Megjegyzések

ProvideLibrary lehetővé teszi, hogy a hibakereső olyan modulokat biztosítson, amelyek adott CLR-fájlok, például mscordbi.dll és mscordacwks.dll hibakereséséhez szükségesek. A modulleíróknak érvényesnek kell maradniuk, amíg az ICLRDebugging::CanUnloadNow metódus hívása nem jelzi, hogy felszabadíthatók, és ekkor a hívó felelőssége felszabadítani a leírókat.

A hibakereső bármilyen rendelkezésre álló eszközzel megkeresheti vagy beszerezheti a hibakeresési modult.

Fontos

Ez a funkció lehetővé teszi, hogy az API-hívó végrehajtható, esetleg rosszindulatú kódot tartalmazó modulokat biztosítson. Biztonsági elővigyázatosságból a hívónak nem ProvideLibrary szabad olyan kódot terjesztenie, amelyet nem hajlandó végrehajtani.

Ha egy már kiadott kódtárban ( például mscordbi.dll vagy mscordacwks.dll) súlyos biztonsági problémát észlel, a biztonsági rés javítható a fájlok rossz verzióinak felismerése érdekében. A shim ezután kéréseket adhat ki a fájlok javított verzióihoz, és elutasíthatja a hibás verziókat, ha bármilyen kérésre válaszul adták őket. Ez csak akkor fordulhat elő, ha a felhasználó javította a shim új verzióját. A nem csomagolt verziók sebezhetőek maradnak.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: CorDebug.idl, CorDebug.h

Könyvtár: CorGuids.lib

.NET-keretrendszer verziók: 4 óta érhető el

Lásd még

• Hibakeresési felületek
• Hibakeresés