Teilen über

_CorValidateImage Function

Überprüft verwaltete Modulimages und benachrichtigt das Betriebssystemladeprogramm nach dem Laden.

Syntax

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

Parameters

ImageBase [in] Ein Zeiger auf den Startort des Bilds, der als verwalteter Code überprüft werden soll. Das Bild muss bereits in den Arbeitsspeicher geladen werden.

FileName [in] Der Dateiname des Bilds.

Return Value

Diese Funktion gibt die Standardwerte E_INVALIDARG, E_OUTOFMEMORY, , E_UNEXPECTEDund E_FAIL, sowie die folgenden Werte zurück.

Return value Description
STATUS_INVALID_IMAGE_FORMAT Das Bild ist ungültig. Dieser Wert weist das HRESULT 0xC000007BL auf.
STATUS_SUCCESS Das Bild ist gültig. Dieser Wert weist das HRESULT 0x00000000L auf.

Remarks

In Windows XP und höheren Versionen sucht das Betriebssystemladeprogramm nach verwalteten Modulen, indem das COM-Deskriptorverzeichnis-Bit im allgemeinen COFF-Header (Object File Format) untersucht wird. Ein Set-Bit gibt ein verwaltetes Modul an. Wenn das Ladeprogramm ein verwaltetes Modul erkennt, wird MsCorEE.dll und Aufrufe _CorValidateImagegeladen, die die folgenden Aktionen ausführen:

  • Bestätigt, dass das Bild ein gültiges verwaltetes Modul ist.

  • Ändert den Einstiegspunkt im Bild in einen Einstiegspunkt in der Common Language Runtime (CLR).

  • Bei 64-Bit-Versionen von Windows ändert das Bild, das sich im Arbeitsspeicher befindet, indem es von PE32 in PE32+ transformiert wird.

  • Kehrt zum Ladeprogramm zurück, wenn die verwalteten Modulimages geladen werden.

Bei ausführbaren Images ruft das Betriebssystemladeprogramm dann die _CorExeMain-Funktion auf, unabhängig vom Einstiegspunkt, der in der ausführbaren Datei angegeben ist. Für DLL-Assemblyimages ruft das Ladeprogramm die _CorDllMain-Funktion auf.

_CorExeMain oder _CorDllMain führt die folgenden Aktionen aus:

  • Initialisiert die CLR.

  • Sucht den verwalteten Einstiegspunkt aus dem CLR-Header der Assembly.

  • Begins execution.

Das Ladeprogramm ruft die _CorImageUnloading-Funktion auf, wenn verwaltete Modulimages entladen werden. Diese Funktion führt jedoch keine Aktion aus. sie gibt einfach zurück.

Requirements

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: Cor.h

Bibliothek: In MsCorEE.dll als Ressource enthalten

.NET Framework-Versionen: Verfügbar seit 1.0

  • Last updated on