Condividi tramite

Funzione GetRequestedRuntimeInfo

Ottiene 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ù valori di enumerazione STARTUP_FLAGS .

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

pDirectory [out] Buffer che contiene il percorso della directory al runtime al termine dell'operazione.

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 completamento corretto.

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

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

Valore restituito

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

Codice restituito Description
S_OK Il metodo è stato completato correttamente.
ERROR_INSUFFICIENT_BUFFER Il buffer della directory non è sufficientemente grande da archiviare il percorso della directory.

- o -

Il buffer della versione non è sufficientemente grande da archiviare la stringa di versione.

Osservazioni:

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 installata più recente 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 di 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.

Intestazione: MSCorEE.h

Libreria: MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 1.1

Vedere anche

  • Last updated on