Aracılığıyla paylaş

ICorProfilerInfo3::GetModuleInfo2 Method

Modül kimliği verilip modülün dosya adını, modülün üst derlemesinin kimliğini ve modülün özelliklerini açıklayan bit maskesi döndürür.

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 [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] Döndürülen modülün dosya adının toplam karakter uzunluğuna ilişkin bir işaretçi.

szName [out] Çağıran 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.

pdwModuleFlags [out] modülün özelliklerini belirten COR_PRF_MODULE_FLAGS numaralandırmasından değerlerin bit maskesi.

Remarks

Dinamik modüller szName için parametresi modülün meta veri adıdır ve temel adres 0 (sıfır) şeklindedir. Meta veri adı, meta verilerin içindeki Modül tablosundaki Ad sütunundaki değerdir. Bu, yönetilen kodun Module.ScopeName özelliği olarak ve yönetilmeyen meta veri istemci koduna IMetaDataImport::GetScopeProps yönteminin parametresi olarak szName da sunulur.

Modül kimliği mevcut olduğunda yöntemi çağrılsa da GetModuleInfo2 , profil oluşturucu ICorProfilerCallback::ModuleAttachedToAssembly geri çağırmasını alıncaya kadar üst derlemenin kimliği kullanılamaz.

Döndürdüğünde GetModuleInfo2 , 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 değeriyle karşılaştırın cchName . 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ınGetModuleInfo2.cchName

Alternatif olarak, doğru arabellek boyutunu elde etmek için önce sıfır uzunlukta GetModuleInfo2 bir arabellekle çağırabilirsinizszName. Ardından arabellek boyutunu içinde döndürülen pcchName değere ayarlayabilir ve yeniden çağırabilirsiniz GetModuleInfo2 .

Requirements

Platformlar: Bkz. Sistem Gereksinimleri.

Üstbilgi: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Sürümleri: 4'ten beri kullanılabilir

See also

  • Last updated on