Metodo ICLRMetaHostPolicy::GetRequestedRuntime

Articolo
04/08/2023

Fornisce un'interfaccia a una versione preferita di Common Language Runtime (CLR) in base a criteri di hosting, un assembly gestito, una stringa di versione e un flusso di configurazione. Questo metodo non carica o attiva clR, ma restituisce semplicemente l'interfaccia ICLRRuntimeInfo che rappresenta il risultato dei criteri. Questo metodo sostituisce i metodi GetRequestedRuntimeInfo, GetRequestedRuntimeVersion, CorBindToRuntimeHost, CorBindToRuntimeByCfg e GetCORRequiredVersion.

Sintassi

HRESULT GetRequestedRuntime(
    [in]  METAHOST_POLICY_FLAGS dwPolicyFlags,
    [in]  LPCWSTR pwzBinary,
    [in]  IStream *pCfgStream,
    [in, out, size_is(*pcchVersion)] LPWSTR pwzVersion,
    [in, out]  DWORD *pcchVersion,
    [out, size_is(*pcchImageVersion)] LPWSTR pwzImageVersion,
    [in, out]  DWORD *pcchImageVersion,
    [out] DWORD *pdwConfigFlags,
    [in]  REFIID  riid
    [out, iid_is(riid), retval] LPVOID *ppRuntime);

Parametri

Nome	Descrizione
`dwPolicyFlags`	[in] Obbligatorio. Specifica un membro dell'enumerazione METAHOST_POLICY_FLAGS , che rappresenta un criterio di associazione e un numero qualsiasi di modificatori. L'unico criterio attualmente disponibile è METAHOST_POLICY_HIGHCOMPAT. I modificatori includono METAHOST_POLICY_EMULATE_EXE_LAUNCH, METAHOST_POLICY_APPLY_UPGRADE_POLICY, METAHOST_POLICY_SHOW_ERROR_DIALOG, METAHOST_POLICY_USE_PROCESS_IMAGE_PATH e METAHOST_POLICY_ENSURE_SKU_SUPPORTED.
`pwzBinary`	[in] Facoltativo. Specifica il percorso del file di assembly.
`pCfgStream`	[in] Facoltativo. Specifica il file di configurazione come oggetto System.Runtime.InteropServices.ComTypes.IStream.
`pwzVersion`	[in, out] Facoltativo. Specifica o restituisce la versione di CLR preferita da caricare.
`pcchVersion`	[in, out] Obbligatorio. Specifica la dimensione prevista di `pwzVersion` come input per evitare sovraccarichi del buffer. Se `pwzVersion` è null, `pcchVersion` contiene le dimensioni previste di `pwzVersion` quando `GetRequestedRuntime` restituisce un valore, per consentire la preallocazione. In caso contrario, `pcchVersion` contiene il numero di caratteri scritti in `pwzVersion`.
`pwzImageVersion`	[out] Facoltativo. Quando `GetRequestedRuntime` viene restituito, contiene la versione CLR corrispondente all'interfaccia ICLRRuntimeInfo restituita.
`pcchImageVersion`	[in, out] Facoltativo. Specifica la dimensione di `pwzImageVersion` come input per evitare sovraccarichi del buffer. Se `pwzImageVersion` è null, `pcchImageVersion` contiene la dimensione richiesta di `pwzImageVersion` quando viene restituito `GetRequestedRuntime`, per consentire la preallocazione.
`pdwConfigFlags`	[out] Facoltativo. Se `GetRequestedRuntime` usa un file di configurazione durante il processo di associazione, quando restituisce, `pdwConfigFlags` contiene un valore METAHOST_CONFIG_FLAGS che indica se l'elemento di avvio> ha l'attributo<`useLegacyV2RuntimeActivationPolicy` impostato e il valore dell'attributo. Applicare la maschera METAHOST_CONFIG_FLAGS_LEGACY_V2_ACTIVATION_POLICY_MASK per `pdwConfigFlags` ottenere i valori pertinenti a `useLegacyV2RuntimeActivationPolicy`.
`riid`	[in] Specifica l'identificatore dell'interfaccia IID_ICLRRuntimeInfo per l'interfaccia ICLRRuntimeInfo richiesta.
`ppRuntime`	[out] Quando `GetRequestedRuntime` restituisce, contiene un puntatore all'interfaccia ICLRRuntimeInfo corrispondente.

Commenti

Quando questo metodo ha esito positivo presenta l'effetto collaterale di combinare flag aggiuntivi con i flag di avvio predefiniti correnti dell'interfaccia di runtime restituita, se e solo se uno o più degli elementi seguenti esiste nel flusso di configurazione all'interno della sezione <configuration><runtime>:

<gcServer enabled="true"/> comporta l'impostazione di STARTUP_SERVER_GC.
<etwEnable enabled="true"/> comporta l'impostazione di STARTUP_ETW.
<appDomainResourceMonitoring enabled="true"/> comporta l'impostazione di STARTUP_ARM.

Il valore STARTUP_FLAGS predefinito risultante è la combinazione OR bit per bit dei valori che vengono impostati dall'elenco precedente con i flag di avvio predefiniti.

Valore restituito

Questo metodo restituisce gli specifici HRESULT seguenti, nonché gli errori di HRESULT che indicano la mancata riuscita del metodo.

HRESULT	Descrizione
S_OK	Metodo completato correttamente.
E_POINTER	`pwzVersion` non è null e `pcchVersion` è null. -oppure- `pwzImageVersion` non è null e `pcchImageVersion` è null.
E_INVALIDARG	`dwPolicyFlags` non specifica `METAHOST_POLICY_HIGHCOMPAT`.
ERROR_INSUFFICIENT_BUFFER	La memoria allocata a `pwzVersion` è inadeguata. -oppure- La memoria allocata a `pwzImageVersion` è inadeguata.
CLR_E_SHIM_RUNTIMELOAD	`dwPolicyFlags` include METAHOST_POLICY_APPLY_UPGRADE_POLICY e `pwzVersion` e `pcchVersion` sono null.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MetaHost.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile da 4

Condividi tramite