Funzione GetRequestedRuntimeInfo

Articolo
08/11/2011

Ottiene informazioni sulla versione e la directory di Common Language Runtime richieste da un'applicazione.

Questa funzione è deprecata in .NET Framework versione 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
);

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ù valori di enumerazione di STARTUP_FLAGS.
runtimeInfoFlags
[in] Uno o più valori di enumerazione di RUNTIME_INFO_FLAGS.
pDirectory
[out] Buffer che contiene il percorso della directory del runtime al termine dell'esecuzione.
dwDirectory
[in] Lunghezza del buffer della directory.
dwDirectoryLength
[out] Puntatore alla lunghezza della stringa del percorso della directory.
pVersion
[out] Buffer che contiene il numero di versione del runtime al termine dell'esecuzione.
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 definiti in WinError.h, oltre ai valori riportati di seguito.

Codice restituito	Oggetto di descrizione
S_OK	Il metodo è stato eseguito correttamente.
ERROR_INSUFFICIENT_BUFFER	La dimensione del buffer della directory non è sufficiente per contenere il percorso della directory. In alternativa La dimensione del buffer della versione non è sufficiente per contenere la stringa di versione.

S_OK

Il metodo è stato eseguito correttamente.

ERROR_INSUFFICIENT_BUFFER

La dimensione del buffer della directory non è sufficiente per contenere il percorso della directory.

In alternativa

La dimensione del buffer della versione non è sufficiente per contenere la stringa di versione.

Note

Il metodo GetRequestedRuntimeInfo 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 sull'ultima versione installata utilizzando il metodo GetRequestedRuntimeInfo come segue:

Specificare i parametri pExe, pwszVersion e pConfigurationFile come null.
Specificare il flag RUNTIME_INFO_UPGRADE_VERSION nelle enumerazioni RUNTIME_INFO_FLAGS per il parametro runtimeInfoFlags.

Il metodo GetRequestedRuntimeInfo non restituisce l'ultima versione di Common Language Runtime nei seguenti casi:

Esiste un file di configurazione dell'applicazione che specifica il caricamento di una particolare versione di Common Language Runtime. .NET Framework utilizzerà il file di configurazione anche se si specifica null per il parametro pConfigurationFile.
Il metodo CorBindToRuntimeEx è stato chiamato specificando una versione precedente di Common Language Runtime.
È in esecuzione un'applicazione compilata per una versione precedente di Common Language Runtime.

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