Interfaccia ICorDebugDataTargetICorDebugDataTarget Interface

Fornisce un'interfaccia di callback che consente di accedere a un determinato processo di destinazione.Provides a callback interface that provides access to a particular target process.

MetodiMethods

MetodoMethod DescrizioneDescription
Metodo GetPlatformGetPlatform Method Vengono fornite informazioni sulla piattaforma, tra cui architettura del processore e il sistema operativo, in cui viene eseguito il processo di destinazione.Provides information about the platform, including processor architecture and operating system, on which the target process is running.
Metodo ReadVirtualReadVirtual Method Ottiene un blocco di memoria contigua a partire dall'indirizzo specificato e lo restituisce nel buffer fornito.Gets a block of contiguous memory starting at the specified address, and returns it in the supplied buffer.
Metodo GetThreadContextGetThreadContext Method Le richieste nel contesto del thread corrente per il thread specificato.Requests the current thread context for the specified thread.

NoteRemarks

ICorDebugDataTarget e i relativi metodi presentano le caratteristiche seguenti:ICorDebugDataTarget and its methods have the following characteristics:

  • I servizi di debug chiamare metodi su questa interfaccia per accedere a memoria e altri dati nel processo di destinazione.The debugging services call methods on this interface to access memory and other data in the target process.

  • Il client del debugger deve implementare questa interfaccia in modo appropriato per la particolare destinazione (ad esempio, un processo reale o un'immagine della memoria).The debugger client must implement this interface as appropriate for the particular target (for example, a live process or a memory dump).

  • Il ICorDebugDataTarget metodi possono essere richiamati solo dai metodi implementati in altro ICorDebug* interfacce.The ICorDebugDataTarget methods can be invoked only from within methods implemented in other ICorDebug* interfaces. In questo modo si garantisce che il client del debugger dispone di controllo su quale thread viene richiamato in e quando.This ensures that the debugger client has control over which thread it is invoked on, and when.

  • Il ICorDebugDataTarget implementazione deve restituire sempre le informazioni aggiornate sulla destinazione.The ICorDebugDataTarget implementation must always return up-to-date information about the target.

Il processo di destinazione deve essere arrestato e non è stato modificato in alcun modo durante ICorDebug* interfacce (e pertanto ICorDebugDataTarget metodi) vengono chiamati.The target process should be stopped and not changed in any way while ICorDebug* interfaces (and therefore ICorDebugDataTarget methods) are being called. Se la destinazione è un processo reale e il relativo stato cambia, il ICLRDebugging:: OpenVirtualProcess metodo deve essere chiamato di nuovo per fornire un'istanza di ICorDebugProcess sostitutiva.If the target is a live process and its state changes, the ICLRDebugging::OpenVirtualProcess method has to be called again to provide a replacement ICorDebugProcess instance.

Nota

Questa interfaccia non supporta la chiamata in modalità remota, tra computer o tra processi.This interface does not support being called remotely, either cross-machine or cross-process.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: Cordebug. idl, Cordebug. HHeader: CorDebug.idl, CorDebug.h

Libreria: CorGuids. libLibrary: CorGuids.lib

Versioni di .NET framework: Disponibile dalla 4Available since 4.NET Framework Versions: Disponibile dalla 4Available since 4

Vedere ancheSee Also

Interfacce di debugDebugging Interfaces
DebugDebugging