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
