Sdílet prostřednictvím

ICLRErrorReportingManager::BeginCustomDump – metoda

Určuje konfiguraci vlastních výpisů paměti haldy pro zasílání zpráv o chybách.

Syntaxe

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

Parametry

dwFlavor
[v] Hodnota ECustomDumpFlavor , která označuje druh výpisu haldy, na kterém se má sestavit vlastní výpis haldy.

dwNumItems
[v] Délka items pole. Pokud dwFlavor není DUMP_FLAVOR_Mini, dwNumItems měla by být nula.

items
[v] Pole instancí CustomDumpItem určující položky, které se mají přidat do mini-výpisu. Pokud dwFlavor není DUMP_FLAVOR_Mini, items měla by mít hodnotu null.

dwReserved
[v] Vyhrazeno pro budoucí použití.

Návratová hodnota

HRESULT Description
S_OK Metoda se úspěšně vrátila.
HOST_E_CLRNOTAVAILABLE Modul CLR (Common Language Runtime) nebyl načten do procesu nebo je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání.
HOST_E_TIMEOUT Časový limit hovoru vypršel.
HOST_E_NOT_OWNER Volající zámek nevlastní.
HOST_E_ABANDONED Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno.
E_FAIL Došlo k neznámému katastrofickému selhání. Jakmile metoda vrátí E_FAIL, clR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE.

Poznámky

Metoda BeginCustomDump nastaví vlastní konfiguraci výpisu haldy. Metoda EndCustomDump vymaže vlastní konfiguraci výpisu haldy a uvolní veškerý přidružený stav. Po dokončení výpisu vlastní haldy by se měl volat.

Důležité

Selhání volání EndCustomDump způsobí nevracení paměti.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovny: Zahrnuto jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také

  • Last updated on