Aracılığıyla paylaş

GetRequestedRuntimeInfo İşlevi

Bir uygulama tarafından istenen ortak dil çalışma zamanı (CLR) hakkında sürüm ve dizin bilgilerini alır.

Bu işlev .NET Framework 4'te kullanım dışı bırakılmıştır.

Sözdizimi

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

Parametreler

pExe [in] Uygulamanın adı.

pwszVersion [in] Çalışma zamanının sürüm numarasını belirten bir dize.

pConfigurationFile [in] ile pExeilişkili yapılandırma dosyasının adı.

startupFlags [in] bir veya daha fazla STARTUP_FLAGS numaralandırma değeri.

runtimeInfoFlags [in] bir veya daha fazla RUNTIME_INFO_FLAGS numaralandırma değeri.

pDirectory [out] Başarıyla tamamlandıktan sonra çalışma zamanının dizin yolunu içeren bir arabellek.

dwDirectory [in] Dizin arabelleğinin uzunluğu.

dwDirectoryLength [out] Dizin yolu dizesinin uzunluğuna ilişkin bir işaretçi.

pVersion [out] Başarıyla tamamlandıktan sonra çalışma zamanının sürüm numarasını içeren bir arabellek.

cchBuffer [in] Sürüm dizesi arabelleğinin uzunluğu.

dwlength [out] Sürüm dizesinin uzunluğuna ilişkin bir işaretçi.

Dönüş Değeri

Bu yöntem, aşağıdaki değerlere ek olarak WinError.h dosyasında tanımlandığı gibi standart Bileşen Nesne Modeli (COM) hata kodlarını döndürür.

İade kodu Description
S_OK Yöntem başarıyla tamamlandı.
HATA_YETERSİZ_TAMPON Dizin arabelleği, dizin yolunu depolayabilecek kadar büyük değil.

-veya-

Sürüm arabelleği, sürüm dizesini depolayabilecek kadar büyük değil.

Açıklamalar

GetRequestedRuntimeInfo yöntemi, işleme yüklenen sürümle ilgili çalışma zamanı bilgilerini döndürür. Bu, bilgisayarda yüklü olması gereken en son sürüm değildir.

.NET Framework sürüm 2.0'da aşağıdaki yöntemi kullanarak GetRequestedRuntimeInfo en son yüklenen sürüm hakkında bilgi edinebilirsiniz:

  • pExe, pwszVersionve pConfigurationFile parametrelerini null olarak belirtin.

  • parametresinin numaralandırmalarında RUNTIME_INFO_FLAGS RUNTIME_INFO_UPGRADE_VERSION bayrağını runtimeInfoFlags belirtin.

GetRequestedRuntimeInfo yöntemi aşağıdaki durumlarda en son CLR sürümünü döndürmez:

  • Belirli bir CLR sürümünün yüklenmesini belirten bir uygulama yapılandırma dosyası var. Parametre için null belirtseniz bile .NET Framework'ün pConfigurationFile yapılandırma dosyasını kullanacağını unutmayın.

  • CorBindToRuntimeEx yöntemi, önceki bir CLR sürümü belirterek çağrıldı.

  • Önceki bir CLR sürümü için derlenmiş bir uygulama şu anda çalışıyor.

parametresi için runtimeInfoFlags , bir kerede numaralandırmanın mimari sabitlerinden RUNTIME_INFO_FLAGS yalnızca birini belirtebilirsiniz:

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: MSCorEE.h

Kitaplık: MSCorEE.dll

.NET Framework Sürümleri: 1.1'den itibaren kullanılabilir

Ayrıca bakınız

  • Last updated on