Delen via

Methode ICorProfilerInfo::GetModuleInfo

  • Artikel

Op basis van een module-id retourneert de bestandsnaam van de module en de id van de bovenliggende assembly van de module.

Syntaxis

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

Parameters

moduleId
[in] De id van de module waarvoor informatie wordt opgehaald.

ppBaseLoadAddress
[uit] Het basisadres waarop de module wordt geladen.

cchName
[in] De lengte, in tekens, van de szName retourbuffer.

pcchName
[uit] Een verwijzing naar de totale tekenlengte van de bestandsnaam van de module die wordt geretourneerd.

szName
[uit] Een brede tekenbuffer die door de aanroeper wordt geleverd. Wanneer de methode retourneert, bevat deze buffer de bestandsnaam van de module.

pAssemblyId
[uit] Een verwijzing naar de id van de bovenliggende assembly van de module.

Opmerkingen

Voor dynamische modules is de szName parameter een lege tekenreeks en is het basisadres 0 (nul).

Hoewel de GetModuleInfo methode kan worden aangeroepen zodra de id van de module bestaat, is de id van de bovenliggende assembly pas beschikbaar als de profiler de callback ICorProfilerCallback::ModuleAttachedToAssembly ontvangt.

Wanneer GetModuleInfo wordt geretourneerd, moet u controleren of de szName buffer groot genoeg is om de volledige bestandsnaam van de module te bevatten. Hiervoor vergelijkt u de waarde die pcchName naar verwijst met de waarde van de cchName parameter. Als pcchName verwijst naar een waarde die groter is dan cchName, wijst u een grotere szName buffer toe, werkt cchName u bij met de nieuwe, grotere grootte en roept u GetModuleInfo opnieuw aan.

U kunt ook eerst aanroepen GetModuleInfo met een buffer met de lengte szName nul om de juiste buffergrootte te verkrijgen. Vervolgens kunt u de buffergrootte instellen op de waarde die wordt geretourneerd in pcchName en opnieuw aanroepen GetModuleInfo .

Vereisten

Platforms: Zie Systeemvereisten.

Header: CorProf.idl, CorProf.h

Bibliotheek: CorGuids.lib

.NET Framework versies: beschikbaar sinds 2.0

Zie ook