Partager via

GetRequestedRuntimeInfo, fonction

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, tels que définis dans WinError.h, en plus des valeurs suivantes.

Code de retour Descriptif
S_OK La méthode s’est terminée avec succès.
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.

Remarques

La GetRequestedRuntimeInfo méthode 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 GetRequestedRuntimeInfo méthode comme suit :

  • Spécifiez les pExeparamètres , pwszVersionet pConfigurationFile spécifiez la valeur Null.

  • Spécifiez l’indicateur RUNTIME_INFO_UPGRADE_VERSION dans les RUNTIME_INFO_FLAGS énumérations du runtimeInfoFlags paramètre.

La GetRequestedRuntimeInfo méthode 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 le .NET Framework utilisera le fichier de configuration même si vous spécifiez null pour le pConfigurationFile paramètre.

  • La méthode CorBindToRuntimeEx a été appelée en spécifiant une version CLR antérieure.

  • Une application compilée pour une version clR antérieure est en cours d’exécution.

Pour le runtimeInfoFlags paramètre, vous ne pouvez spécifier qu’une des constantes d’architecture de l’énumération à la RUNTIME_INFO_FLAGS 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

Voir aussi

  • Last updated on