Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
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ő