ICLRDebugManager::BeginConnection – metoda
Vytvoří nové připojení mezi hostitelem a ladicím programem pro přidružení seznamu úkolů s identifikátorem a popisným názvem.
Syntaxe
HRESULT BeginConnection (
[in] CONNID dwConnectionId,
[in, string] wchar_t* szConnectionName
);
Parametry
dwConnectionId
[v] Identifikátor, který se přidruží k seznamu úloh modulu CLR (Common Language Runtime).
szConnectionName
[v] Popisný název, který se přidruží k seznamu úloh CLR.
Návratová hodnota
| HRESULT | Description |
|---|---|
| S_OK | BeginConnection úspěšně vráceno. |
| HOST_E_CLRNOTAVAILABLE | ClR nebyl načten do procesu nebo clr 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, zatímco na ni čekalo blokované vlákno nebo vlákno. |
| E_FAIL | Došlo k neznámému závažnému selhání. Jakmile metoda vrátí E_FAIL, clr už není možné v rámci procesu použít. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE. |
| E_INVALIDARG | dwConnectionId byla nula, nebo BeginConnection byla již volána pomocí této dwConnectionId hodnoty nebo szConnectionName byla null. |
| E_OUTOFMEMORY | Nelze přidělit dostatek paměti pro uložení seznamu úkolů přidružených k tomuto připojení. |
Poznámky
ICLRDebugManager poskytuje tři metody, BeginConnectionSetConnectionTasks a EndConnection, pro přidružení seznamů úkolů k identifikátorům a popisným názvům.
Důležité
Tyto tři metody musí být volána v určitém pořadí pro každou sadu úkolů. BeginConnection se nejprve volá, aby se navázalo nové připojení. SetConnectionTasks Je volána vedle a poskytuje sadu úkolů, které mají být přidruženy k danému připojení. EndConnection Je volána poslední, aby se odstranilo přidružení mezi seznamem úkolů a identifikátorem a popisným názvem. Volání různých připojení však mohou být vnořená.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: MSCorEE.h
Knihovny: Zahrnutý jako prostředek v MSCorEE.dll
Verze rozhraní .NET Framework: K dispozici od verze 2.0
