Bagikan melalui

Fungsi GetRequestedRuntimeInfo

  • Artikel

Mendapatkan informasi versi dan direktori tentang runtime bahasa umum (CLR) yang diminta oleh aplikasi.

Fungsi ini tidak digunakan lagi di .NET Framework 4.

Sintaks

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

Parameter

pExe
[in] Nama aplikasi.

pwszVersion
[in] String yang menentukan nomor versi runtime.

pConfigurationFile
[in] Nama file konfigurasi yang terkait dengan pExe.

startupFlags
[in] Satu atau beberapa nilai enumerasi STARTUP_FLAGS.

runtimeInfoFlags
[in] Satu atau beberapa nilai enumerasi RUNTIME_INFO_FLAGS.

pDirectory
[out] Buffer yang berisi jalur direktori ke runtime setelah berhasil diselesaikan.

dwDirectory
[in] Panjang buffer direktori.

dwDirectoryLength
[out] Penunjuk ke panjang string jalur direktori.

pVersion
[out] Buffer yang berisi string nomor versi runtime setelah berhasil diselesaikan.

cchBuffer
[in] Panjang buffer string versi.

dwlength
[out] Penunjuk ke panjang string versi.

Tampilkan Nilai

Metode ini mengembalikan kode kesalahan Model Objek Dokumen (COM) standar, seperti yang didefinisikan dalam WinError.h, selain nilai-nilai berikut.

Menampilkan kode Deskripsi
S_OK Metode berhasil diselesaikan.
ERROR_INSUFFICIENT_BUFFER Buffer direktori tidak cukup besar untuk menyimpan jalur direktori.

- atau -

Buffer versi tidak cukup besar untuk menyimpan string versi.

Keterangan

Metode GetRequestedRuntimeInfo ini mengembalikan informasi run-time tentang versi yang dimuat ke dalam proses, yang belum tentu merupakan versi terbaru yang diinstal pada komputer.

Dalam .NET Framework versi 2.0, Anda bisa mendapatkan informasi tentang versi terbaru yang diinstal dengan menggunakan GetRequestedRuntimeInfo metode sebagai berikut:

  • Tentukan parameter pExe, pwszVersion, dan pConfigurationFile sebagai null.

  • Tentukan bendera RUNTIME_INFO_UPGRADE_VERSION dalam enumerasi RUNTIME_INFO_FLAGS untuk parameter runtimeInfoFlags.

Metode GetRequestedRuntimeInfo ini tidak mengembalikan versi CLR terbaru dalam keadaan berikut:

  • File konfigurasi aplikasi yang menentukan pemuatan versi CLR tertentu ada. Perhatikan bahwa .NET Framework akan menggunakan file konfigurasi meskipun Anda menentukan null untuk parameter pConfigurationFile.

  • Metode CorBindToRuntimeEx dipanggil untuk menentukan versi CLR sebelumnya.

  • Aplikasi yang dikompilasi untuk versi CLR sebelumnya saat ini sedang berjalan.

Untuk parameter runtimeInfoFlags, Anda hanya dapat menentukan salah satu konstanta arsitektur dari enumerasi RUNTIME_INFO_FLAGS pada satu waktu:

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 1.1

Lihat juga