Funzione GetRequestedRuntimeInfo

Articolo
04/08/2023

Ottiene le informazioni sulla versione e sulla directory relative a Common Language Runtime (CLR) richieste da un'applicazione.

Questa funzione è stata deprecata in .NET Framework 4.

Sintassi

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  
);

Parametri

pExe
[in] Nome dell'applicazione.

pwszVersion
[in] Stringa che specifica il numero di versione del runtime.

pConfigurationFile
[in] Nome del file di configurazione associato a pExe.

startupFlags
[in] Uno o più dei valori di enumerazione STARTUP_FLAGS .

runtimeInfoFlags
[in] Uno o più dei valori di enumerazione RUNTIME_INFO_FLAGS .

pDirectory
[out] Buffer che contiene il percorso della directory al runtime al termine del completamento.

dwDirectory
[in] Lunghezza del buffer della directory.

dwDirectoryLength
[out] Puntatore alla lunghezza della stringa del percorso della directory.

pVersion
[out] Buffer contenente il numero di versione del runtime al termine del completamento.

cchBuffer
[in] Lunghezza del buffer della stringa di versione.

dwlength
[out] Puntatore alla lunghezza della stringa di versione.

Valore restituito

Questo metodo restituisce i codici di errore COM (Component Object Model) standard, come definito in WinError.h, oltre ai valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
ERROR_INSUFFICIENT_BUFFER	Il buffer della directory non è abbastanza grande per archiviare il percorso della directory. - oppure - Il buffer della versione non è abbastanza grande per archiviare la stringa di versione.

Commenti

Il GetRequestedRuntimeInfo metodo restituisce informazioni di runtime sulla versione caricata nel processo, che non è necessariamente la versione più recente installata nel computer.

In .NET Framework versione 2.0 è possibile ottenere informazioni sulla versione più recente installata usando il GetRequestedRuntimeInfo metodo come indicato di seguito:

Specificare i pExeparametri , pwszVersione pConfigurationFile come null.
Specificare il flag RUNTIME_INFO_UPGRADE_VERSION nelle RUNTIME_INFO_FLAGS enumerazioni per il runtimeInfoFlags parametro.

Il GetRequestedRuntimeInfo metodo non restituisce la versione CLR più recente nelle circostanze seguenti:

Esiste un file di configurazione dell'applicazione che specifica il caricamento di una determinata versione CLR. Si noti che .NET Framework userà il file di configurazione anche se si specifica Null per il pConfigurationFile parametro.
Il metodo CorBindToRuntimeEx è stato chiamato specificando una versione CLR precedente.
Un'applicazione compilata per una versione CLR precedente è attualmente in esecuzione.

Per il runtimeInfoFlags parametro è possibile specificare solo una delle costanti dell'architettura dell'enumerazione RUNTIME_INFO_FLAGS alla volta:

RUNTIME_INFO_REQUEST_IA64
RUNTIME_INFO_REQUEST_AMD64
RUNTIME_INFO_REQUEST_X86

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: MSCorEE.dll

Versioni di .NET Framework: Disponibile da 1.1

Condividi tramite