Bagikan melalui

Metode ICorProfilerInfo::GetModuleInfo

Mengingat ID modul, mengembalikan nama file modul dan ID rakitan induk modul.

Sintaks

HRESULT GetModuleInfo(  
    [in]  ModuleID   moduleId,  
    [out] LPCBYTE    *ppBaseLoadAddress,  
    [in]  ULONG      cchName,  
    [out] ULONG      *pcchName,  
    [out, size_is(cchName), length_is(*pcchName)]  
          WCHAR      szName[] ,  
    [out] AssemblyID *pAssemblyId);

Parameter

moduleId
[in] ID dari modul yang informasinya akan diambil.

ppBaseLoadAddress
[out] Alamat dasar tempat modul dimuat.

cchName
[in] Panjang, dalam karakter, dari buffer pengembalian szName.

pcchName
[out] Penunjuk ke total panjang karakter nama file modul yang dikembalikan.

szName
[out] Buffer karakter lebar yang disediakan pemanggil. Saat metode kembali, buffer ini berisi nama file modul.

pAssemblyId
[out] Penunjuk ke ID rakitan induk modul.

Keterangan

Untuk modul dinamis, parameter szName adalah string kosong, dan alamat dasarnya adalah 0 (nol).

Meskipun metode GetModuleInfo dapat dipanggil segera setelah ID modul ada, ID rakitan induk tidak akan tersedia sampai profiler menerima panggilan balik ICorProfilerCallback::ModuleAttachedToAssembly.

Setelah GetModuleInfo kembali, Anda harus memverifikasi bahwa buffer szName cukup besar untuk berisi nama file lengkap modul. Untuk melakukannya, bandingkan nilai yang ditunjuk pcchName dengan nilai parameter cchName. Jika pcchName menunjuk ke nilai yang lebih besar dari cchName, alokasikan buffer szName yang lebih besar, perbarui cchName dengan ukuran baru yang lebih besar, dan panggil GetModuleInfo lagi.

Atau, Anda dapat terlebih dahulu memanggil GetModuleInfo dengan buffer szName kosong untuk mendapatkan ukuran buffer yang benar. Kemudian, Anda dapat mengatur ukuran buffer ke nilai yang dikembalikan di pcchName dan memanggil GetModuleInfo lagi.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: CorProf.idl, CorProf.h

Pustaka: CorGuids.lib

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on