Funzione _CorValidateImage_CorValidateImage Function

Convalida delle immagini dei moduli gestiti e notifica al caricatore del sistema operativo dopo che sono stati caricati.Validates managed module images, and notifies the operating system loader after they have been loaded.

SintassiSyntax

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

ParametriParameters

ImageBase
[in] Puntatore alla posizione iniziale dell'immagine per convalidare come codice gestito.[in] A pointer to the starting location of the image to validate as managed code. L'immagine deve essere già caricata in memoria.The image must already be loaded into memory.

FileName
[in] Il nome file dell'immagine.[in] The file name of the image.

Valore restituitoReturn Value

Questa funzione restituisce i valori standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, e E_FAIL, nonché i valori seguenti.This function returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following values.

Valore restituitoReturn value DescrizioneDescription
STATUS_INVALID_IMAGE_FORMAT L'immagine non è valido.The image is invalid. Questo valore HRESULT 0xC000007BL.This value has the HRESULT 0xC000007BL.
STATUS_SUCCESS L'immagine è valido.The image is valid. Questo valore HRESULT 0x00000000L.This value has the HRESULT 0x00000000L.

NoteRemarks

In Windows XP e versioni successive, il caricatore del sistema operativo controlla la presenza di moduli gestiti esaminando il bit di Directory descrittore COM nell'intestazione common object file formato COFF ().In Windows XP and later versions, the operating system loader checks for managed modules by examining the COM Descriptor Directory bit in the common object file format (COFF) header. Un bit impostato indica un modulo gestito.A set bit indicates a managed module. Se il caricatore rileva un modulo gestito, carica MsCorEE.dll e chiama _CorValidateImage, che esegue le azioni seguenti:If the loader detects a managed module, it loads MsCorEE.dll and calls _CorValidateImage, which performs the following actions:

  • Conferma che l'immagine è un modulo gestito valido.Confirms that the image is a valid managed module.

  • Modifica il punto di ingresso nell'immagine per un punto di ingresso in common language runtime (CLR).Changes the entry point in the image to an entry point in the common language runtime (CLR).

  • Per le versioni a 64 bit di Windows, modifica l'immagine presente in memoria trasformandola dal formato PE32 al formato PE32 +.For 64-bit versions of Windows, modifies the image that is in memory by transforming it from PE32 to PE32+ format.

  • Restituisce un valore per il caricatore quando le immagini dei moduli gestiti caricati.Returns to the loader when the managed module images are loaded.

Per le immagini eseguibili, il caricatore del sistema operativo chiama quindi il CorExeMain funzione, indipendentemente dal punto di ingresso specificato nel file eseguibile.For executable images, the operating system loader then calls the _CorExeMain function, regardless of the entry point specified in the executable. Per le immagini di assembly DLL, il caricatore chiama la CorDllMain (funzione).For DLL assembly images, the loader calls the _CorDllMain function.

_CorExeMain o _CorDllMain esegue le azioni seguenti:_CorExeMain or _CorDllMain performs the following actions:

  • Inizializza il CLR.Initializes the CLR.

  • Individua il punto di ingresso gestito dall'intestazione CLR dell'assembly.Locates the managed entry point from the assembly's CLR header.

  • Inizia l'esecuzione.Begins execution.

Le chiamate del caricatore di CorImageUnloading funzione quando gestito immagini vengono scaricate.The loader calls the _CorImageUnloading function when managed module images are unloaded. Tuttavia, questa funzione non esegue alcuna operazione. Restituisce solo.However, this function does not perform any action; it just returns.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: Cor. hHeader: Cor.h

Libreria: inclusa come risorsa in Mscoree. dllLibrary: Included as a resource in MsCorEE.dll

Versioni di .NET framework: Disponibile dalla 1.0Available since 1.0.NET Framework Versions: Disponibile dalla 1.0Available since 1.0

Vedere ancheSee Also

Funzioni statiche globali dei metadatiMetadata Global Static Functions