ICorProfilerInfo7::ReadInMemorySymbols

  • Artikel

[Wird nur in .NET Framework 4.6.1 und höheren Versionen unterstützt]

Liest Bytes aus einem Speichersymboldatenstrom.

Syntax

HRESULT ReadInMemorySymbols(  
        [in] ModuleID moduleId,  
        [in] DWORD symbolsReadOffset,  
        [out] BYTE* pSymbolBytes,  
        [in] DWORD countSymbolBytes,  
        [out] DWORD* pCountSymbolBytesRead  
);

Parameter

moduleId
[in] Der Bezeichner des Moduls, das den Speicherdatenstrom enthält.

symbolsReadOffset
[in] Der Offset innerhalb des Speicherdatenstroms, bei dem das Lesen von Bytes gestartet werden soll.

pSymbolBytes
[out] Ein Zeiger auf den Puffer, in den die Daten kopiert werden. Der Puffer sollte über countSymbolBytes verfügbaren Speicherplatz verfügen.

countSymbolBytes
[in] Die Anzahl der zu kopierenden Bytes.

pCountSymbolBytesRead
[out] Wenn die Methode zurückgegeben wird, enthält sie die tatsächliche Anzahl der gelesenen Bytes.

Rückgabewert

S_OK, wenn eine Zahl von Bytes, die nicht Null ist, gelesen wurde.

CORPROF_E_MODULE_IS_DYNAMIC, wenn das Modul mit System.Reflection.Emit erstellt wurde.

Hinweise

Die ReadInMemorySymbols-Methode versucht, countSymbolBytes Daten ab dem Offset symbolsReadOffset im Speicherdatenstrom zu lesen. Die Daten werden nach pSymbolBytes kopiert, wo voraussichtlich countSymbolBytes Speicherplatz zur Verfügung steht. pCountSymbolsBytesRead enthält die tatsächliche Anzahl der gelesenen Bytes, die kleiner als countSymbolBytes sein kann, wenn das Ende des Datenstroms erreicht ist.

Hinweis

Die aktuelle Implementierung unterstützt keine Reflection.Emit. Wenn das Modul mithilfe von Reflection.Emit erstellt wurde, gibt die Methode CORPROF_E_MODULE_IS_DYNAMIC zurück.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit Version 4.6.1 verfügbar

Weitere Informationen