Sdílet prostřednictvím

_CorValidateImage – funkce

  • Článek

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

Viz také