Metodo ICLRDataTarget3::GetExceptionContextRecord

Articolo
11/05/2024

Chiamato dai servizi di accesso ai dati di Common Language Runtime (CLR) per recuperare il record di contesto associato al processo destinazione. Ad esempio, per una destinazione di dump, questo equivale al record di contesto passato tramite l'argomento ExceptionParam alla funzione MiniDumpWriteDump nella libreria della Guida di debug di Windows (DbgHelp).

Sintassi

HRESULT GetExceptionContextRecord(
    [in] ULONG32 bufferSize,
    [out] ULONG32* bufferUsed,
    [out, size_is(bufferSize)] BYTE* buffer
);

Parametri

bufferSize [in] Dimensioni del buffer di input, in byte. Questa deve essere sufficientemente grande per poter contenere il record di contesto.

bufferUsed [out] Puntatore a un ULONG32 tipo che riceve il numero di byte effettivamente scritti nel buffer.

buffer [out] Puntatore a un buffer di memoria che riceve una copia del record di contesto. Il record di eccezione viene restituito come tipo CONTEXT .

Valore restituito

Il valore restituito è S_OK in caso di esito positivo o un codice di errore HRESULT in caso di esito negativo. I codici HRESULT possono includere, ma non sono limitati a, quanto segue:

Codice restituito	Descrizione
`S_OK`	Il metodo è riuscito. Il record di contesto è stato copiato nel buffer di output.
`HRESULT_FROM_WIN32(ERROR_NOT_FOUND)`	Nessun record di contesto è associato alla destinazione.
`HRESULT_FROM_WIN32(ERROR_BAD_LENGTH)`	La dimensione del buffer di input non è sufficientemente grande per poter contenere il record di contesto.

Osservazioni:

CONTEXT è una struttura specifica della piattaforma definita nelle intestazioni fornite da Windows SDK.

Questo metodo è implementato dal writer dell'applicazione di debug.

Requisiti

Piattaforme: vedere Requisiti di sistema.

Intestazione: ClrData.idl, ClrData.h

Libreria: CorGuids.lib

Versioni di .NET Framework: disponibili dall'aggiornamento di novembre 2013 alla versione 4.5.1

Condividi tramite