IDebugProcess2::Attach

Dołącza menedżera debugowania sesji (SDM) do procesu.

Składnia

C#

int Attach( 
   IDebugEventCallback2 pCallback,
   Guid[]               rgguidSpecificEngines,
   uint                 celtSpecificEngines,
   int[]                rghrEngineAttach
);

C++

HRESULT Attach( 
   IDebugEventCallback2* pCallback,
   GUID*                 rgguidSpecificEngines,
   DWORD                 celtSpecificEngines,
   HRESULT*              rghrEngineAttach
);

Parametry

pCallback
[in] Obiekt IDebugEventCallback2 używany do powiadamiania o zdarzeniu debugowania.

rgguidSpecificEngines
[in] Tablica identyfikatorów GUID aparatów debugowania używanych do debugowania programów uruchomionych w procesie. Ten parametr może być wartością null. Aby uzyskać szczegółowe informacje, zobacz Uwagi.

celtSpecificEngines
[in] Liczba aparatów debugowania w tablicy rgguidSpecificEngines i rozmiar tablicy rghrEngineAttach .

rghrEngineAttach
[in, out] Tablica kodów HRESULT zwracanych przez aparaty debugowania. Rozmiar tej tablicy jest określony w parametrze celtSpecificEngines . Każdy kod jest zwykle S_OK lub S_ATTACH_DEFERRED. Ten ostatni wskazuje, że DE jest obecnie dołączony do żadnych programów.

Wartość zwracana

Jeśli operacja powiedzie się, zwraca wartość S_OK; w przeciwnym razie zwraca kod błędu. W poniższej tabeli przedstawiono inne możliwe wartości.

Wartość	Opis
E_ATTACH_DEBUGGER_ALREADY_ATTACHED	Określony proces jest już dołączony do debugera.
E_ATTACH_DEBUGGEE_PROCESS_SECURITY_VIOLATION	Podczas procedury dołączania wystąpiło naruszenie zabezpieczeń.
E_ATTACH_CANNOT_ATTACH_TO_DESKTOP	Nie można dołączyć procesu klasycznego do debugera.

Uwagi

Dołączanie do procesu dołącza sdM do wszystkich programów uruchomionych w tym procesie, które mogą być debugowane przez aparaty debugowania (DE) określone w tablicy rgguidSpecificEngines . rgguidSpecificEngines Ustaw parametr na wartość null lub dołącz GUID_NULL do tablicy, aby dołączyć do wszystkich programów w procesie.

Wszystkie zdarzenia debugowania występujące w procesie są wysyłane do danego obiektu IDebugEventCallback2 . Ten IDebugEventCallback2 obiekt jest udostępniany, gdy sdM wywołuje tę metodę.

Zobacz też

• IDebugProcess2
• IDebugEventCallback2