Freigeben über

IXCLRDataProcess::GetRuntimeNameByAddress-Methode

  • Artikel

Ruft einen Namen für die angegebene Adresse ab.

Hinweis

Diese API wurde ursprünglich für die interne Verwendung in der Runtime entwickelt. Obwohl sie jetzt für die Verwendung durch Dritte unterstützt wird, wird empfohlen, nach Möglichkeit mit den APIs ICorDebug und ICorProfiler zu arbeiten.

Syntax

HRESULT GetRuntimeNameByAddress(
    [in] CLRDATA_ADDRESS address,
    [in] ULONG32 flags,
    [in] ULONG32 bufLen,
    [out] ULONG32 *nameLen,
    [out, size_is(bufLen)] WCHAR nameBuf[],
    [out] CLRDATA_ADDRESS* displacement
);

Parameter

address
[in] Ein CLRDATA_ADDRESS-Wert, der eine Codeadresse darstellt.

flags
[in] Auf „0“ festgelegt.

bufLen
[in] Die Länge des Puffers.

namLen
[out] Ein Zeiger auf die Anzahl der zurückgegebenen Zeichen.

namBuf
[out, size_is(bufLen)] Der Eingabepuffer der Länge bufLen, in dem der Runtimename gespeichert wird.

displacement
[out] Ein CLRDATA_ADDRESS-Zeiger auf den Codeoffset des zurückgegebenen Symbols.

Bemerkungen

Die bereitgestellte Methode ist Teil der IXCLRDataProcess-Schnittstelle und entspricht dem 16. Slot der Tabelle virtueller Methoden.

Hinweis

Wenn der Puffer für den Namen nicht groß genug ist, gibt diese Methode S_FALSE zurück und legt nameLen auf die erforderliche Pufferlänge fest.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen
Header: Keiner
Bibliothek: Keine
.NET Framework-Versionen: Seit Version 4.7 verfügbar

Siehe auch