GetRequestedRuntimeInfo, fonction

Article
05/10/2023

Obtient des informations de version et de répertoire sur le Common Language Runtime (CLR) demandé par une application.

Cette fonction a été déconseillée dans .NET Framework 4.

Syntaxe

HRESULT GetRequestedRuntimeInfo (  
    [in]  LPCWSTR  pExe,
    [in]  LPCWSTR  pwszVersion,
    [in]  LPCWSTR  pConfigurationFile,
    [in]  DWORD    startupFlags,
    [in]  DWORD    runtimeInfoFlags,
    [out] LPWSTR   pDirectory,
    [in]  DWORD    dwDirectory,
    [out] DWORD   *dwDirectoryLength,
    [out] LPWSTR   pVersion,
    [in]  DWORD    cchBuffer,
    [out] DWORD   *dwlength  
);

Paramètres

pExe
[in] Nom de l’application.

pwszVersion
[in] Chaîne spécifiant le numéro de version du runtime.

pConfigurationFile
[in] Nom du fichier de configuration associé à pExe.

startupFlags
[in] Une ou plusieurs valeurs d’énumération STARTUP_FLAGS.

runtimeInfoFlags
[in] Une ou plusieurs valeurs d’énumération RUNTIME_INFO_FLAGS.

pDirectory
[out] Mémoire tampon qui contient le chemin d’accès du répertoire au runtime une fois l’exécution terminée.

dwDirectory
[in] Longueur de la mémoire tampon du répertoire.

dwDirectoryLength
[out] Pointeur vers la longueur de la chaîne de chemin d’accès du répertoire.

pVersion
[out] Mémoire tampon qui contient le numéro de version du runtime une fois l’exécution terminée.

cchBuffer
[in] Longueur de la mémoire tampon de chaîne de version.

dwlength
[out] Pointeur vers la longueur de la chaîne de version.

Valeur de retour

Cette méthode retourne des codes d’erreur COM (Component Object Model) standard, comme défini dans WinError.h, en plus des valeurs suivantes.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
ERROR_INSUFFICIENT_BUFFER	La mémoire tampon du répertoire n’est pas suffisamment grande pour stocker le chemin d’accès au répertoire. - ou - La mémoire tampon de version n’est pas suffisamment grande pour stocker la chaîne de version.

Notes

La méthode GetRequestedRuntimeInfo retourne des informations d’exécution sur la version chargée dans le processus, ce qui n’est pas nécessairement la dernière version installée sur l’ordinateur.

Dans .NET Framework version 2.0, vous pouvez obtenir des informations sur la dernière version installée à l’aide de la méthode GetRequestedRuntimeInfo comme suit :

Spécifiez les paramètres pExe, pwszVersion et pConfigurationFile comme null.
Spécifiez l’indicateur RUNTIME_INFO_UPGRADE_VERSION dans les énumérations RUNTIME_INFO_FLAGS pour le paramètre runtimeInfoFlags.

La méthode GetRequestedRuntimeInfo ne retourne pas la dernière version du CLR dans les circonstances suivantes :

Un fichier de configuration d’application qui spécifie le chargement d’une version CLR particulière existe. Notez que .NET Framework utilise le fichier de configuration même si vous spécifiez null pour le paramètre pConfigurationFile.
La méthode CorBindToRuntimeEx a été appelée en spécifiant une version CLR antérieure.
Une application qui a été compilée pour une version antérieure du CLR est en cours d’exécution.

Pour le paramètre runtimeInfoFlags, vous ne pouvez spécifier qu’une des constantes d’architecture de l’énumération RUNTIME_INFO_FLAGS à la fois :

RUNTIME_INFO_REQUEST_IA64
RUNTIME_INFO_REQUEST_AMD64
RUNTIME_INFO_REQUEST_X86

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : MSCorEE.dll

Versions du .NET Framework : Disponible depuis la version 1.1

Partager via