ICorProfilerInfo3::GetModuleInfo2 – metoda

Vzhledem k ID modulu vrátí název souboru modulu, ID nadřazeného sestavení modulu a bitovou masku, která popisuje vlastnosti modulu.

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 [v] ID modulu, pro který se načtou informace.

ppBaseLoadAddress [ven] Základní adresa, na kterou se modul načte.

cchName [v] Délka návratové szName vyrovnávací paměti ve znaméně.

pcchName [ven] Ukazatel na celkovou délku znaku vráceného názvu souboru modulu.

szName [ven] Vyrovnávací paměť znaků poskytnutá volajícím. Když metoda vrátí, tato vyrovnávací paměť obsahuje název souboru modulu.

pAssemblyId [ven] Ukazatel na ID nadřazeného sestavení modulu.

pdwModuleFlags [ven] Bitová maska hodnot z COR_PRF_MODULE_FLAGS výčtu, která určuje vlastnosti modulu.

Remarks

U dynamických modulů szName je parametr názvem metadat modulu a základní adresa je 0 (nula). Název metadat je hodnota ve sloupci Název z tabulky Modulu v metadatech. Tato vlastnost je také vystavena Module.ScopeName jako vlastnost spravovaného kódu a jako szName parametr IMetaDataImport::GetScopeProps metodu nespravovaného kódu klienta metadat.

GetModuleInfo2 I když metoda může být volána, jakmile id modulu existuje, ID nadřazeného sestavení nebude k dispozici, dokud profiler neobdrží ICorProfilerCallback::ModuleAttachedToAssembly zpětné volání.

Při GetModuleInfo2 návratu szName musíte ověřit, že vyrovnávací paměť byla dostatečně velká, aby obsahovala úplný název souboru modulu. Chcete-li to provést, porovnejte hodnotu, která pcchName odkazuje na hodnotu parametru cchName . Pokud pcchName odkazuje na hodnotu, která je větší než cchName, přidělte větší szName vyrovnávací paměť, aktualizujte cchName novou, větší velikost a znovu volejte GetModuleInfo2 .

Případně můžete nejprve zavolat GetModuleInfo2 vyrovnávací paměť s nulovou délkou szName , abyste získali správnou velikost vyrovnávací paměti. Velikost vyrovnávací paměti pak můžete nastavit na hodnotu vrácenou a pcchName znovu zavolat GetModuleInfo2 .

Requirements

Platformy: Viz požadavky na systém.

Záhlaví: CorProf.idl, CorProf.h

Knihovna: CorGuids.lib

Verze rozhraní .NET Framework: K dispozici od 4

Viz také

  • Last updated on