Compartir a través de


ICLRErrorReportingManager::BeginCustomDump (Método)

Especifica la configuración de volcados de montón personalizados para los informes de errores.

Sintaxis

HRESULT BeginCustomDump (  
    [in] ECustomDumpFlavor dwFlavor,  
    [in] DWORD dwNumItems,  
    [in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],  
    DWORD dwReserved  
);  

Parámetros

dwFlavor
[in] Valor ECustomDumpFlavor que indica el tipo de volcado de montón en el que se va a compilar el volcado de montón personalizado.

dwNumItems
[in] Longitud de la matriz items. Si dwFlavor no es DUMP_FLAVOR_Mini, dwNumItems debe ser cero.

items
[in] Matriz de instancias de CustomDumpItem que especifica los elementos que se van a agregar al minivolcado. Si dwFlavor no es DUMP_FLAVOR_Mini, items debe ser null.

dwReserved
[in] Reservado para uso futuro.

Valor devuelto

HRESULT Descripción
S_OK El método se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Si se devuelve este valor, significa que ocurrió un error grave desconocido. Una vez que un método devuelva el valor E_FAIL, CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.

Comentarios

El método BeginCustomDump establece la configuración de volcado de montón personalizado. El método EndCustomDump borra la configuración de volcado de montón personalizado y libera cualquier estado asociado. A este método se le debe llamar una vez completado el volcado de montón personalizado.

Importante

Si llamar a EndCustomDump produce un error, la memoria se pierde.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también