_CorValidateImage Function

Valideert installatiekopieën van beheerde modules en meldt het besturingssysteemlaadprogramma nadat deze zijn geladen.

Syntax

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

Parameters

ImageBase [in] Een aanwijzer naar de beginlocatie van de installatiekopieën om te valideren als beheerde code. De installatiekopieën moeten al in het geheugen worden geladen.

FileName [in] De bestandsnaam van de afbeelding.

Return Value

Deze functie retourneert de standaardwaarden E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTEDen E_FAIL, evenals de volgende waarden.

Return value	Description
STATUS_INVALID_IMAGE_FORMAT	De afbeelding is ongeldig. Deze waarde heeft de HRESULT 0xC000007BL.
STATUS_SUCCESS	De afbeelding is geldig. Deze waarde heeft de HRESULT 0x00000000L.

Remarks

In Windows XP en latere versies controleert het besturingssysteemlader op beheerde modules door de COM Descriptor Directory-bit in de COFF-header (Common Object File Format) te controleren. Een set bit geeft een beheerde module aan. Als het laadprogramma een beheerde module detecteert, worden MsCorEE.dll en aanroepen _CorValidateImagegeladen, waarmee de volgende acties worden uitgevoerd:

• Bevestigt dat de installatiekopieën een geldige beheerde module zijn.

• Hiermee wijzigt u het toegangspunt in de afbeelding in een toegangspunt in de Common Language Runtime (CLR).

• Voor 64-bits versies van Windows wijzigt u de installatiekopieën die zich in het geheugen bevinden door deze te transformeren van PE32 naar PE32+-indeling.

• Keert terug naar het laadprogramma wanneer de installatiekopieën van de beheerde module worden geladen.

Voor uitvoerbare installatiekopieën roept het besturingssysteemlaadprogramma vervolgens de _CorExeMain-functie aan, ongeacht het ingangspunt dat is opgegeven in het uitvoerbare bestand. Voor DLL-assembly-installatiekopieën roept het laadprogramma de _CorDllMain-functie aan.

_CorExeMain of _CorDllMain voert de volgende acties uit:

• Initialiseert de CLR.

• Zoekt het beheerde toegangspunt uit de CLR-header van de assembly.

• Begins execution.

De loader roept de _CorImageUnloading-functie aan wanneer installatiekopieën van beheerde modules worden verwijderd. Deze functie voert echter geen actie uit; Het keert gewoon terug.

Requirements

Platformen: Zie Systeemvereisten.

Header: Cor.h

Bibliotheek: Opgenomen als een resource in MsCorEE.dll

.NET Framework-versies: Beschikbaar sinds 1.0