Sdílet prostřednictvím

IDebugProgramEx2::Attach

  • Článek

Připojte relaci k programu.

Syntaxe

int Attach( 
   IDebugEventCallback2 pCallback,
   uint                 dwReason,
   IDebugSession2       pSession
);

Parametry

pCallback
[v] IDebugEventCallback2 objekt, který představuje funkci zpětného volání, do které připojený ladicí modul odesílá události.

dwReason
[v] Hodnota z ATTACH_REASON výčtu, která popisuje důvod operace připojení.

pSession
[v] Hodnota, která jednoznačně identifikuje relaci, která se připojuje k programu.

Vrácená hodnota

V případě úspěchu vrátí hodnotu S_OK; v opačném případě vrátí kód chyby. Tato metoda by se měla vrátit E_ATTACH_DEBUGGER_ALREADY_ATTACHED , pokud je program již připojen.

Poznámky

Port, který obsahuje program, může hodnotu použít pSession k určení relace, která se pokouší připojit k programu. Pokud například port umožňuje připojení k procesu současně jenom jedné ladicí relaci, port může určit, jestli je stejná relace již připojená k jiným programům v procesu.

Poznámka:

Rozhraní předané pSession je považováno za soubor cookie, což je hodnota, která jednoznačně identifikuje správce ladění relace, který se připojuje k tomuto programu. Žádná z metod na zadaném rozhraní není funkční.

Viz také