ICLRErrorReportingManager::BeginCustomDump — Metoda

  • Artykuł

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

Zobacz też