_CorValidateImage – funkce
Ověří image spravovaných modulů a po načtení upozorní zavaděč operačního systému.
Syntaxe
STDAPI _CorValidateImage (
[in] PVOID* ImageBase,
[in] LPCWSTR FileName
);
Parametry
ImageBase
[v] Ukazatel na počáteční umístění obrázku, který se má ověřit jako spravovaný kód. Image už musí být načtená do paměti.
FileName
[v] Název souboru obrázku.
Návratová hodnota
Tato funkce vrátí standardní hodnoty E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTEDa E_FAILa také následující hodnoty.
| Vrácená hodnota | Description |
|---|---|
STATUS_INVALID_IMAGE_FORMAT |
Obrázek je neplatný. Tato hodnota má HODNOTU HRESULT 0xC000007BL. |
STATUS_SUCCESS |
Obrázek je platný. Tato hodnota má HODNOTU HRESULT 0x00000000L. |
Poznámky
V systému Windows XP a novějších verzích zavaděč operačního systému kontroluje spravované moduly tím, že v hlavičce common object file format (COFF) zkontroluje bit deskriptoru COM Descriptor. Nastavený bit označuje spravovaný modul. Pokud zavaděč rozpozná spravovaný modul, načte MsCorEE.dll a zavolá _CorValidateImage, který provede následující akce:
Potvrdí, že image je platným spravovaným modulem.
Změní vstupní bod v imagi na vstupní bod v modulu CLR (Common Language Runtime).
V 64bitových verzích Windows upraví image, která je v paměti, tím, že ji transformuje z formátu PE32 na PE32+.
Vrátí se do zavaděče při načtení imagí spravovaných modulů.
Pro spustitelné bitové kopie pak zavaděč operačního systému zavolá funkci _CorExeMain bez ohledu na vstupní bod zadaný ve spustitelném souboru. Pro bitové kopie sestavení knihovny DLL zavaděč volá funkci _CorDllMain .
_CorExeMain nebo _CorDllMain provede následující akce:
Inicializuje CLR.
Vyhledá spravovaný vstupní bod z hlavičky CLR sestavení.
Zahájí provádění.
Zavaděč volá funkci _CorImageUnloading při uvolnění imagí spravovaných modulů. Tato funkce však neprovede žádnou akci; prostě se vrátí.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: Kor.h
Knihovny: Zahrnuto jako prostředek v MsCorEE.dll
Verze rozhraní .NET Framework: K dispozici od verze 1.0
