ICLRErrorReportingManager::BeginCustomDump (Método)

Artículo
10/07/2008

Actualización: noviembre 2007

Especifica la configuración de los volcados del montón personalizados para el informe de errores.

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

Parámetros

dwFlavor
[in] Uno de los valores de ECustomDumpFlavor, que indica el tipo de volcado del montón sobre el que se generará el volcado del montón personalizado.
dwNumItems
[in] Longitud de la matriz items. Si dwFlavor no es DUMP_FLAVOR_Mini, dwNumItems debería ser cero.
items
[in] Matriz de instancias de CustomDumpItem, que especifica los elementos que se agregarán 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	Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el 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 llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error irrecuperable desconocido. Cuando un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

El método BeginCustomDump establece la configuración personalizada del volcado del montón. El método EndCustomDump borra la configuración personalizada del volcado del montón y libera los estados asociados. Se debe llamar una vez finalizado el volcado del montón personalizado.