ICLRErrorReportingManager::BeginCustomDump — Metoda
Określa konfigurację niestandardowych zrzutów sterty na potrzeby raportowania błędów.
Składnia
HRESULT BeginCustomDump (
[in] ECustomDumpFlavor dwFlavor,
[in] DWORD dwNumItems,
[in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],
DWORD dwReserved
);
Parametry
dwFlavor
[w] Wartość ECustomDumpFlavor , która wskazuje rodzaj zrzutu stert, na którym można utworzyć niestandardowy zrzut stert.
dwNumItems
[w] Długość tablicy items . Jeśli dwFlavor nie jest DUMP_FLAVOR_Mini, dwNumItems powinno to być zero.
items
[w] Tablica wystąpień CustomDumpItem określająca elementy do dodania do mini-zrzutu. Jeśli dwFlavor nie jest DUMP_FLAVOR_Mini, items powinna mieć wartość null.
dwReserved
[w] Zarezerwowane do użytku w przyszłości.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | Metoda została zwrócona pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane do procesu lub CLR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania. |
| HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
| HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
| HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
| E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwróci E_FAIL, clR nie będzie już można używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
Uwagi
Metoda ustawia niestandardową BeginCustomDump konfigurację zrzutu stert. Metoda EndCustomDump czyści niestandardową konfigurację zrzutu stert i zwalnia wszystkie skojarzone stany. Powinien być wywoływany po zakończeniu niestandardowego zrzutu stert.
Ważne
Błąd wywołania EndCustomDump powoduje wyciek pamięci.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
.NET Framework wersje: dostępne od wersji 2.0
