Metodo ICorDebugCode3::GetReturnValueLiveOffsetICorDebugCode3::GetReturnValueLiveOffset Method

Per un offset IL specificato, ottiene gli offset nativi in un punto di interruzione deve essere posizionato in modo che il debugger è possibile ottenere il valore restituito da una funzione.For a specified IL offset, gets the native offsets where a breakpoint should be placed so that the debugger can obtain the return value from a function.

SintassiSyntax

HRESULT GetReturnValueLiveOffset(  
    [in] ULONG32 ILoffset,  
    [in] ULONG32 bufferSize,   
    [out] ULONG32 *pFetched,   
    [out, size_is(buffersize), length_is(*pFetched)] ULong32 pOffsets[]  
);  

ParametriParameters

ILoffset
Offset IL.The IL offset. Deve essere un sito di chiamata di funzione o la chiamata di funzione non riuscirà.It must be a function call site or the function call will fail.

bufferSize
Il numero di byte disponibili per archiviare pOffsets.The number of bytes available to store pOffsets.

pFetched
Puntatore al numero di offset effettivamente restituiti.A pointer to the number of offsets actually returned. In genere, il relativo valore è 1, ma è possibile eseguire il mapping di una singola istruzione IL multiplo CALL le istruzioni di assembly.Usually, its value is 1, but a single IL instruction can map to multiple CALL assembly instructions.

pOffsets
Matrice di offset nativi.An array of native offsets. In genere, pOffsets contiene solo un offset, anche se è possibile eseguire il mapping di una singola istruzione di linguaggio intermedio con mapping più in più CALL le istruzioni di assembly.Typically, pOffsets contains a single offset, although a single IL instruction can map to multiple map to multiple CALL assembly instructions.

NoteRemarks

Questo metodo viene utilizzato insieme al icordebugilframe3:: Getreturnvalueforiloffset metodo per ottenere il valore restituito di un metodo che restituisce un tipo di riferimento.This method is used along with the ICorDebugILFrame3::GetReturnValueForILOffset method to get the return value of a method that returns a reference type. Il passaggio di un offset a un sito di chiamata di funzione per questo metodo IL restituisce uno o più offset nativi.Passing an IL offset to a function call site to this method returns one or more native offsets. Il debugger può quindi impostare i punti di interruzione in questi offset nativi nella funzione.The debugger can then set breakpoints on these native offsets in the function. Quando il debugger raggiunge uno dei punti di interruzione, è quindi possibile passare lo stesso offset IL che è stato passato a questo metodo per il icordebugilframe3:: Getreturnvalueforiloffset metodo per ottenere il valore restituito.When the debugger hits one of the breakpoints, you can then pass the same IL offset that you passed to this method to the ICorDebugILFrame3::GetReturnValueForILOffset method to get the return value. Il debugger deve quindi deselezionare tutti i punti di interruzione è impostato.The debugger should then clear all the breakpoints that it set.

Avviso

Il ICorDebugCode3::GetReturnValueLiveOffset e icordebugilframe3:: Getreturnvalueforiloffset metodi consentono di ottenere informazioni sul valore restituito per solo i tipi di riferimento.The ICorDebugCode3::GetReturnValueLiveOffset and ICorDebugILFrame3::GetReturnValueForILOffset methods allow you to get return value information for reference types only. Recupero delle informazioni di valore restituito da tipi di valore (vale a dire tutti i tipi che derivano da ValueType) non è supportata.Retrieving return value information from value types (that is, all types that derive from ValueType) is not supported.

La funzione restituisce il HRESULT sui valori indicati nella tabella seguente.The function returns the HRESULT values shown in the following table.

Valore di HRESULTHRESULT value DescrizioneDescription
S_OK Operazione completata.Success.
CORDBG_E_INVALID_OPCODE Il sito di offset IL specificato non è un'istruzione di chiamata o la funzione restituisce void.The given IL offset site is not a call instruction, or the function returns void.
CORDBG_E_UNSUPPORTED L'offset IL specificato è una chiamata corretta, ma il tipo restituito non è supportato per il recupero di un valore restituito.The given IL offset is a proper call, but the return type is unsupported for getting a return value.

Il ICorDebugCode3::GetReturnValueLiveOffset metodo è disponibile solo nel server basato su x86 e sistemi AMD64.The ICorDebugCode3::GetReturnValueLiveOffset method is available only on x86-based and AMD64 systems.

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 4.5.1Available since 4.5.1.NET Framework Versions: Disponibile dalla 4.5.1Available since 4.5.1

Vedere ancheSee Also

Metodo GetReturnValueForILOffsetGetReturnValueForILOffset Method
Interfaccia ICorDebugCode3ICorDebugCode3 Interface