_CorValidateImage Function

Ověří image spravovaného modulu a po načtení upozorní zavaděč operačního systému.

Syntax

STDAPI _CorValidateImage (
   [in] PVOID* ImageBase,
   [in] LPCWSTR FileName
);

Parameters

ImageBase [v] Ukazatel na počáteční umístění image, který se má ověřit jako spravovaný kód. Image již musí být načtena do paměti.

FileName [v] Název souboru obrázku.

Return Value

Tato funkce vrátí standardní hodnoty E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTEDa E_FAIL, a také následující hodnoty.

Return value	Description
STATUS_INVALID_IMAGE_FORMAT	Image je neplatná. Tato hodnota má HRESULT 0xC000007BL.
STATUS_SUCCESS	Image je platná. Tato hodnota má HRESULT 0x00000000L.

Remarks

Ve Windows XP a novějších verzích zavaděč operačního systému kontroluje spravované moduly prozkoumáním bitu adresáře deskriptoru MODELU COM v hlavičce COFF (Common Object File Format). Bit sady označuje spravovaný modul. Pokud zavaděč zjistí spravovaný modul, načte MsCorEE.dll a volání _CorValidateImage, která provádí 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).

• U 64bitových verzí Systému Windows upraví image, která je v paměti, tím, že ji transformuje z formátu PE32 na PE32+ nebo novější.

• Vrátí se do zavaděče při načtení imagí spravovaného modulu.

U spustitelných imagí zavaděč operačního systému potom volá funkci _CorExeMain bez ohledu na vstupní bod zadaný ve spustitelném souboru. U imagí sestavení knihovny DLL zavaděč volá funkci _CorDllMain .

_CorExeMain nebo _CorDllMain provádí následující akce:

• Inicializuje CLR.

• Vyhledá spravovaný vstupní bod z hlavičky CLR sestavení.

• Begins execution.

Zavaděč volá funkci _CorImageUnloading při uvolnění imagí spravovaných modulů. Tato funkce však neprovádí žádnou akci; jen se vrátí.

Requirements

Platformy: Viz požadavky na systém.

Header: Cor.h

Knihovna: Zahrnutý jako prostředek v MsCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 1.0