ICorDebugModule3::CreateReaderForInMemorySymbols — Metoda

Tworzy czytnik symboli debugowania dla modułu dynamicznego.

Składnia

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

Parametry

riid
[in] Identyfikator IID interfejsu COM do zwrócenia. Zazwyczaj jest to interfejs ISymUnmanagedReader.

ppObj
[out] Wskaźnik do wskaźnika do zwróconego interfejsu.

Wartość zwracana

S_OK
Pomyślnie utworzono czytelnika.

CORDBG_E_MODULE_LOADED_FROM_DISK
Moduł nie jest modułem w pamięci ani dynamicznym.

CORDBG_E_SYMBOLS_NOT_AVAILABLE
Symbole nie zostały dostarczone przez aplikację lub nie są jeszcze dostępne.

E_FAIL (lub inne E_ kody powrotne)
Nie można utworzyć czytnika.

Uwagi

Tej metody można również użyć do utworzenia obiektu czytnika symboli dla modułów w pamięci (niedynamicznych), ale dopiero po pierwszym udostępnieniu symboli (wskazywanych przez wywołanie zwrotne metody UpdateModuleSymbols ).

Ta metoda zwraca nowe wystąpienie czytnika za każdym razem, gdy jest wywoływana (na przykład CComPtrBase::CoCreateInstance). W związku z tym debuger powinien buforować wynik i zażądać nowego wystąpienia tylko wtedy, gdy dane bazowe mogły ulec zmianie (czyli po odebraniu wywołania zwrotnego metody LoadClass ).

Moduły dynamiczne nie mają żadnych symboli dostępnych do momentu załadowania pierwszego typu (wskazanego przez wywołanie zwrotne metody LoadClass ).

Requirements

Platformy: Zobacz Obsługiwane systemy operacyjne platformy .NET.

Nagłówek: CorDebug.idl, CorDebug.h

Biblioteka: CorGuids.lib

Wersje platformy .NET: 4.5, 4, 3.5 SP1

Zobacz także

• ICorDebugRemoteTarget, interfejs
• ICorDebug, interfejs