ICorProfilerInfo::GetModuleInfo Yöntemi

  • Makale

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

Ayrıca bkz.