_CorValidateImage függvény
Ellenőrzi a felügyelt modul lemezképeit, és értesíti az operációs rendszer betöltőt a betöltésük után.
Szintaxis
STDAPI _CorValidateImage (
[in] PVOID* ImageBase,
[in] LPCWSTR FileName
);
Paraméterek
ImageBase
[in] A rendszerkép kezdő helyére mutató mutató, amely felügyelt kódként érvényesíti a rendszerképet. A képet már be kell tölteni a memóriába.
FileName
[in] A kép fájlneve.
Visszatérési érték
Ez a függvény a standard értékeket E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, és E_FAIL, valamint az alábbi értékeket adja vissza.
| Visszatérítési érték | Leírás |
|---|---|
STATUS_INVALID_IMAGE_FORMAT |
A kép érvénytelen. Ez az érték a HRESULT 0xC000007BL értékkel rendelkezik. |
STATUS_SUCCESS |
A kép érvényes. Ez az érték HRESULT 0x0000000L értékkel rendelkezik. |
Megjegyzések
Windows XP és újabb verziókban az operációs rendszer betöltője felügyelt modulokat keres a COM Leíró könyvtár bit vizsgálatával a közös objektumfájlformátum (COFF) fejlécében. A beállított bit egy felügyelt modult jelöl. Ha a betöltő egy felügyelt modult észlel, betölti MsCorEE.dll és meghívja _CorValidateImageazokat, amelyek a következő műveleteket hajtják végre:
Megerősíti, hogy a rendszerkép érvényes felügyelt modul.
A kép belépési pontját a közös nyelvi futtatókörnyezet (CLR) belépési pontjára módosítja.
A Windows 64 bites verziói esetén a PE32-ről PE32+ formátumra alakítva módosítja a memóriában lévő képet.
A felügyelt modul lemezképeinek betöltésekor visszatér a betöltőhöz.
Végrehajtható rendszerképek esetén az operációs rendszer betöltője ezután meghívja a _CorExeMain függvényt, függetlenül a végrehajtható fájlban megadott belépési ponttól. DLL-szerelvényképek esetén a betöltő meghívja a _CorDllMain függvényt.
_CorExeMain vagy _CorDllMain végrehajtja a következő műveleteket:
Inicializálja a CLR-t.
Megkeresi a felügyelt belépési pontot a szerelvény CLR-fejlécéből.
Megkezdi a végrehajtást.
A betöltő meghívja a _CorImageUnloading függvényt a felügyelt modul lemezképeinek eltávolításakor. Ez a függvény azonban nem hajt végre semmilyen műveletet; csak visszatér.
Követelmények
Platformok: Lásd: Rendszerkövetelmények.
Fejléc: Cor.h
Könyvtár: Erőforrásként szerepel a MsCorEE.dll
.NET-keretrendszer verziók: 1.0 óta érhető el
