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