Bagikan melalui

ICorProfilerInfo3::GetModuleInfo2 Method

Mengingat ID modul, mengembalikan nama file modul, ID rakitan induk modul, dan bitmask yang menjelaskan properti modul.

Syntax

HRESULT GetModuleInfo2(
    [in]  ModuleID   moduleId,
    [out] LPCBYTE    *ppBaseLoadAddress,
    [in]  ULONG      cchName,
    [out] ULONG      *pcchName,
    [out, annotation("__out_ecount_part(cchName, *pcchName)")]
          WCHAR      szName[] ,
    [out] AssemblyID *pAssemblyId);
    [out] DWORD                 *pdwModuleFlags);

Parameters

moduleId [di] ID modul tempat informasi akan diambil.

ppBaseLoadAddress [out] Alamat dasar tempat modul dimuat.

cchName [di] Panjangnya, dalam karakter, dari szName buffer pengembalian.

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

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

pAssemblyId [out] Penunjuk ke ID perakitan induk modul.

pdwModuleFlags [out] Bitmask nilai dari enumerasi COR_PRF_MODULE_FLAGS yang menentukan properti modul.

Remarks

Untuk modul dinamis, szName parameter adalah nama metadata modul, dan alamat dasarnya adalah 0 (nol). Nama metadata adalah nilai dalam kolom Nama dari tabel Modul di dalam metadata. Ini juga diekspos sebagai Module.ScopeName properti untuk kode terkelola, dan sebagai szName parameter metode IMetaDataImport::GetScopeProps ke kode klien metadata yang tidak dikelola.

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

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

Atau, Anda dapat terlebih dahulu memanggil GetModuleInfo2 dengan buffer panjang szName nol untuk mendapatkan ukuran buffer yang benar. Anda kemudian dapat mengatur ukuran buffer ke nilai yang dikembalikan pcchName dan memanggil GetModuleInfo2 lagi.

Requirements

Platform: Lihat Persyaratan Sistem.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

Versi .NET Framework: Tersedia sejak 4

See also

  • Last updated on