GetRequestedRuntimeInfo, fonction

Article
08/10/2011

Obtient les informations liées à la version et au répertoire concernant le Common Language Runtime (CLR) demandé par une application.

Cette fonction est déconseillée dans le .NET Framework version 4.

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 des valeurs d'énumération STARTUP_FLAGS.
runtimeInfoFlags
[in] Une ou plusieurs des valeurs d'énumération RUNTIME_INFO_FLAGS.
pDirectory
[out] Mémoire tampon qui, au moment de la fin, contient le chemin d'accès au répertoire du runtime.
dwDirectory
[in] Longueur de la mémoire tampon du répertoire.
dwDirectoryLength
[out] Pointeur vers la longueur de la chaîne du chemin d'accès au répertoire.
pVersion
[out] Mémoire tampon qui, au moment de la fin, contient le numéro de version du runtime.
cchBuffer
[in] Longueur de la mémoire tampon de la 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 standard tels que définis dans WinError.h en plus des valeurs suivantes.

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

S_OK

La méthode s'est correctement terminée.

ERROR_INSUFFICIENT_BUFFER

Mémoire tampon du répertoire insuffisante pour stocker le chemin d'accès au répertoire.

- ou -

Mémoire tampon de la version insuffisante pour stocker la chaîne de version.

Notes

La méthode GetRequestedRuntimeInfo retourne des informations d'exécution à propos de la version chargée dans le processus, qui n'est pas nécessairement la version la plus récente installée sur l'ordinateur.

Dans le .NET Framework version 2.0, vous pouvez obtenir des informations sur la dernière version installée en utilisant 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 cas suivants :

Fichier de configuration de l'application qui spécifie le chargement d'une version du CLR particulière. Notez que le .NET Framework utilisera 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 indiquant une version antérieure du CLR.
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 seule des constantes d'architecture de l'énumération RUNTIME_INFO_FLAGS à la fois :