ICLRDataTarget3::GetExceptionContextRecord (Método)
Los servicios de acceso a datos de Common Language Runtime (CLR) llaman a esta función para recuperar el registro de contexto asociado con el proceso de destino. Por ejemplo, para un destino de volcado de memoria, esto sería equivalente al registro de contexto pasado a través del argumento ExceptionParam a la función MiniDumpWriteDump de Windows Debug Help Library (DbgHelp).
Sintaxis
HRESULT GetExceptionContextRecord(
[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. Debe ser suficientemente grande como para contener el registro de contexto.
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 contexto. El registro de excepciones se devuelve como un tipo CONTEXT.
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 contexto se ha copiado en el búfer de salida. |
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) |
No hay ningún registro de contexto asociado al destino. |
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) |
El tamaño del búfer de entrada no es suficientemente grande para alojar el registro de contexto. |
Comentarios
CONTEXT es una estructura específica de plataforma definida en encabezados proporcionados por 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
