Megosztás a következőn keresztül:


ICorProfilerInfo::GetModuleInfo metódus

A modul azonosítójának megadva visszaadja a modul fájlnevét és a modul szülőszerelvényének azonosítóját.

Szintaxis

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);  

Paraméterek

moduleId
[in] Annak a modulnak az azonosítója, amelynek adatait lekéri.

ppBaseLoadAddress
[kifelé] Az alapcím, amelyen a modul betöltődik.

cchName
[in] A visszatérési szName puffer hossza karakterekben.

pcchName
[kifelé] A visszaadott modul fájlnevének teljes karakterhosszára mutató mutató.

szName
[kifelé] A hívó által biztosított széles karakterpuffer. A metódus visszaadásakor ez a puffer tartalmazza a modul fájlnevét.

pAssemblyId
[kifelé] A modul szülőszerelvényének azonosítójára mutató mutató.

Megjegyzések

Dinamikus modulok esetén a szName paraméter egy üres sztring, az alapcím pedig 0 (nulla).

Bár a GetModuleInfo metódus meghívható, amint a modul azonosítója létezik, a szülőszerelvény azonosítója nem lesz elérhető, amíg a profilkészítő nem kapja meg az ICorProfilerCallback::ModuleAttachedToAssembly visszahívást .

A visszatéréskor GetModuleInfo ellenőriznie kell, hogy a szName puffer elég nagy volt-e ahhoz, hogy tartalmazza a modul teljes fájlnevét. Ehhez hasonlítsa össze a pont értékét pcchName a cchName paraméter értékével. Ha pcchName nagyobb értékre mutat, cchNamefoglaljon le egy nagyobb szName puffert, frissítsen cchName az új, nagyobb mérettel, és hívja újra a hívást GetModuleInfo .

Másik lehetőségként meghívhat GetModuleInfo egy nulla hosszúságú szName puffert a megfelelő pufferméret eléréséhez. Ezután beállíthatja a pufferméretet a visszaadott pcchName értékre, majd újra meghívhatja GetModuleInfo .

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: CorProf.idl, CorProf.h

Könyvtár: CorGuids.lib

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még