ICorProfilerInfo::GetModuleInfo Yöntemi
Modül kimliği verüldüğünde, modülün dosya adını ve modülün üst derlemesinin kimliğini döndürür.
Sözdizimi
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);
Parametreler
moduleId
[in] Bilgilerin alınacağı modülün kimliği.
ppBaseLoadAddress
[out] Modülün yüklendiği temel adres.
cchName
[in] Dönüş arabelleğinin szName karakter cinsinden uzunluğu.
pcchName
[out] Modülün döndürülen dosya adının toplam karakter uzunluğuna işaret eden bir işaretçi.
szName
[out] Arayan tarafından sağlanan geniş karakter arabelleği. Yöntemi döndürdüğünde, bu arabellek modülün dosya adını içerir.
pAssemblyId
[out] Modülün üst derlemesinin kimliğinin işaretçisi.
Açıklamalar
Dinamik modüller szName için parametresi boş bir dizedir ve temel adres 0 (sıfır) olur.
Modül kimliği mevcut olduğunda yöntem çağrılsa da GetModuleInfo , profil oluşturucu ICorProfilerCallback::ModuleAttachedToAssembly geri çağırmasını alıncaya kadar üst derlemenin kimliği kullanılamaz.
Döndürdüğünde GetModuleInfo , arabelleğin modülün szName tam dosya adını içerecek kadar büyük olduğunu doğrulamanız gerekir. Bunu yapmak için işaret eden pcchName değeri parametresinin cchName değeriyle karşılaştırın. değerinden büyük bir değere işaret edersepcchName, daha büyük szName bir arabellek ayırın, yeni, daha büyük boyutla güncelleştirin cchName ve yeniden çağırınGetModuleInfo.cchName
Alternatif olarak, doğru arabellek boyutunu elde etmek için ilk GetModuleInfo olarak sıfır uzunlukta szName bir arabellek çağırabilirsiniz. Daha sonra arabellek boyutunu döndürülen pcchName değere ayarlayabilir ve yeniden çağırabilirsiniz GetModuleInfo .
Gereksinimler
Platform: Bkz. Sistem Gereksinimleri.
Üstbilgi: CorProf.idl, CorProf.h
Kitaplığı: CorGuids.lib
.NET Framework Sürümleri: 2.0 sürümünden itibaren kullanılabilir
