Bagikan melalui

Fungsi GetRequestedRuntimeInfo

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

Fungsi ini tidak digunakan lagi di .NET Framework 4.

Syntax

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-parameternya

pExe [di] Nama aplikasi.

pwszVersion [di] String yang menentukan nomor versi runtime.

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

startupFlags [di] Satu atau beberapa nilai enumerasi STARTUP_FLAGS .

runtimeInfoFlags [di] Satu atau beberapa nilai enumerasi RUNTIME_INFO_FLAGS .

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

dwDirectory [di] Panjang buffer direktori.

dwDirectoryLength [out] Penunjuk ke panjang string jalur direktori.

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

cchBuffer [di] Panjang buffer string versi.

dwlength [out] Penunjuk ke panjang string versi.

Mengembalikan Nilai

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

Mengembalikan kode Description
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.

Komentar

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

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

  • pExeTentukan parameter , pwszVersion, dan pConfigurationFile sebagai null.

  • Tentukan bendera RUNTIME_INFO_UPGRADE_VERSION dalam RUNTIME_INFO_FLAGS enumerasi untuk runtimeInfoFlags parameter .

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

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

  • Metode CorBindToRuntimeEx disebut menentukan versi CLR sebelumnya.

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

runtimeInfoFlags Untuk parameter , Anda hanya dapat menentukan salah satu konstanta RUNTIME_INFO_FLAGS arsitektur enumerasi 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 sejak 1.1

Lihat juga

  • Last updated on