Metodo ICorDebugModule3::CreateReaderForInMemorySymbols

Crea un lettore di simboli di debug per un modulo dinamico.

Sintassi

HRESULT CreateReaderForInMemorySymbols (
      [in] REFIID riid,
      [out][iid_is(riid)] void **    ppObj

Parametri

riid
[in] IID dell'interfaccia COM da restituire. In genere, si tratta di un'interfaccia ISymUnmanagedReader.

ppObj
[out] Puntatore a un puntatore all'interfaccia restituita.

Valore restituito

S_OK
Il lettore è stato creato correttamente.

CORDBG_E_MODULE_LOADED_FROM_DISK
Il modulo non è un modulo in memoria o dinamico.

CORDBG_E_SYMBOLS_NOT_AVAILABLE
I simboli non sono stati forniti dall'applicazione o non sono ancora disponibili.

E_FAIL (o altri E_ codici restituiti)
Impossibile creare il lettore.

Osservazioni:

Questo metodo può essere usato anche per creare un oggetto lettore di simboli per i moduli in memoria (non dinamici), ma solo dopo la prima disponibilità dei simboli (indicato dal callback del metodo UpdateModuleSymbols ).

Questo metodo restituisce una nuova istanza del lettore ogni volta che viene chiamata, ad esempio CComPtrBase::CoCreateInstance. Pertanto, il debugger deve memorizzare nella cache il risultato e richiedere una nuova istanza solo quando i dati sottostanti possono essere stati modificati, ovvero quando viene ricevuto un callback del metodo LoadClass .

I moduli dinamici non dispongono di simboli disponibili fino al caricamento del primo tipo (come indicato dal callback del metodo LoadClass ).

Requisiti

Piattaforme: Vedere Sistemi operativi supportati da .NET.

Intestazione: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versioni di .NET: 4.5, 4, 3.5 SP1

Vedere anche

• Interfaccia ICorDebugRemoteTarget
• Interfaccia ICorDebug