Udostępnij za pośrednictwem

IDebugProgramEx2::Attach

  • Artykuł

Dołączanie sesji do programu.

Składnia

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

Parametry

pCallback
[in] Obiekt IDebugEventCallback2 reprezentujący funkcję wywołania zwrotnego, do którego dołączony aparat debugowania wysyła zdarzenia.

dwReason
[in] Wartość z wyliczenia ATTACH_REASON , która opisuje przyczynę operacji dołączania.

pSession
[in] Wartość, która jednoznacznie identyfikuje sesję dołączaną do programu.

Wartość zwracana

Jeśli operacja powiedzie się, zwraca wartość S_OK; w przeciwnym razie zwraca kod błędu. Ta metoda powinna zostać zwrócona E_ATTACH_DEBUGGER_ALREADY_ATTACHED , jeśli program jest już dołączony.

Uwagi

Port zawierający program może użyć wartości w pliku , pSession aby określić, która sesja próbuje dołączyć do programu. Jeśli na przykład port zezwala tylko jednej sesji debugowania na dołączanie do procesu w danym momencie, port może określić, czy ta sama sesja jest już dołączona do innych programów w procesie.

Uwaga

Przekazany interfejs pSession jest traktowany tylko jako plik cookie, czyli wartość, która jednoznacznie identyfikuje menedżera debugowania sesji dołączanego do tego programu. Żadna z metod w podanym interfejsie nie działa.

Zobacz też