Freigeben über

ICorProfilerInfo3::GetModuleInfo2 Method

Gibt bei einer Modul-ID den Dateinamen des Moduls, die ID der übergeordneten Assembly des Moduls und eine Bitmaske zurück, die die Eigenschaften des Moduls beschreibt.

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] Die ID des Moduls, für das Informationen abgerufen werden.

ppBaseLoadAddress [out] Die Basisadresse, an der das Modul geladen wird.

cchName [in] Die Länge des Rückgabepuffers szName in Zeichen.

pcchName [out] Ein Zeiger auf die Gesamtzeichenlänge des zurückgegebenen Dateinamens des Moduls.

szName [out] Ein vom Aufrufer bereitgestellter breit angelegter Zeichenpuffer. Wenn die Methode zurückgegeben wird, enthält dieser Puffer den Dateinamen des Moduls.

pAssemblyId [out] Ein Zeiger auf die ID der übergeordneten Assembly des Moduls.

pdwModuleFlags [out] Eine Bitmaske von Werten aus der COR_PRF_MODULE_FLAGS Enumeration, die die Eigenschaften des Moduls angeben.

Remarks

Bei dynamischen Modulen ist der szName Parameter der Metadatenname des Moduls, und die Basisadresse ist 0 (null). Der Metadatenname ist der Wert in der Spalte "Name" aus der Modultabelle in Metadaten. Dies wird auch als Module.ScopeName Eigenschaft für verwalteten Code und als szName Parameter der IMetaDataImport::GetScopeProps-Methode für nicht verwalteten Metadatenclientcode verfügbar gemacht.

Obwohl die GetModuleInfo2 Methode möglicherweise aufgerufen wird, sobald die ID des Moduls vorhanden ist, ist die ID der übergeordneten Assembly erst verfügbar, wenn der Profiler den ICorProfilerCallback::ModuleAttachedToAssembly-Rückruf empfängt.

Beim GetModuleInfo2 Zurückgeben müssen Sie überprüfen, ob der szName Puffer groß genug war, um den vollständigen Dateinamen des Moduls zu enthalten. Vergleichen Sie dazu den Wert, pcchName der mit dem Wert des cchName Parameters verweist. Wenn pcchName auf einen Wert verweist, der größer als cchNameist, weisen Sie einen größeren szName Puffer zu, aktualisieren Sie cchName es mit der neuen, größeren Größe, und rufen Sie es erneut auf GetModuleInfo2 .

Alternativ können Sie zuerst einen Puffer der Länge GetModuleInfo2 Null aufrufenszName, um die richtige Puffergröße abzurufen. Anschließend können Sie die Puffergröße auf den zurückgegebenen pcchName Wert festlegen und erneut aufrufen GetModuleInfo2 .

Requirements

Plattformen: Informationen finden Sie unter Systemanforderungen.

Kopfball: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework-Versionen: Verfügbar seit 4

See also

  • Last updated on