ICLRDataTarget3::GetExceptionRecord (Método)
Los servicios de acceso a datos de Common Language Runtime (CLR) llaman a esta función para recuperar el registro de excepciones asociado con el proceso de destino. Por ejemplo, para un destino de volcado de memoria, esto sería equivalente al registro de excepciones pasado a través del argumento ExceptionParam a la función MiniDumpWriteDump en la biblioteca de ayuda de depuración de Windows (DbgHelp).
Sintaxis
HRESULT GetExceptionRecord(
[in] ULONG32 bufferSize,
[out] ULONG32* bufferUsed,
[out, size_is(bufferSize] BYTE* buffer
);
Parámetros
bufferSize [in] Tamaño del búfer de entrada, en bytes. Este debe ser igual a sizeof(MINIDUMP_EXCEPTION).
bufferUsed [out] Puntero a un ULONG32 tipo que recibe el número de bytes realmente escritos en el búfer.
buffer [out] Puntero a un búfer de memoria que recibe una copia del registro de excepción. El registro de excepciones se devuelve como un tipo MINIDUMP_EXCEPTION.
Valor devuelto
El valor devuelto es S_OK si se realiza correctamente, o un código de error HRESULT en caso contrario. Entre los códigos HRESULT que se pueden devolver se incluyen los siguientes, entre otros:
| Código devuelto | Descripción |
|---|---|
S_OK |
El método se realizó correctamente. El registro de excepciones se ha copiado en el búfer de salida. |
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) |
No hay ningún registro de excepciones asociado al destino. |
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) |
El tamaño del búfer de entrada no es igual a sizeof(MINIDUMP_EXCEPTION). |
Comentarios
MINIDUMP_EXCEPTION es una estructura definida en dbghelp.h e imagehlp.h en Windows SDK.
Este método lo implementa el escritor de la aplicación de depuración.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: ClrData.idl, ClrData.h
Biblioteca: CorGuids.lib
Versiones de .NET Framework: Disponible desde la actualización de noviembre de 2013 a la versión 4.5.1
