IDebugClient5::AttachProcess 메서드(dbgeng.h)

AttachProcess 메서드는 디버거 엔진 사용자 모드 프로세서에 연결합니다.

통사론

HRESULT AttachProcess(
  [in] ULONG64 Server,
  [in] ULONG   ProcessId,
  [in] ULONG   AttachFlags
);

[in] Server

프로세스에 연결하는 데 사용할 프로세스 서버를 지정합니다. Server 0이면 엔진은 프로세스 서버를 사용하지 않고 로컬 프로세스에 연결합니다.

[in] ProcessId

디버거가 연결할 대상 프로세스의 프로세스 ID를 지정합니다.

[in] AttachFlags

디버거가 대상 프로세스에 연결하는 방법을 제어하는 플래그를 지정합니다. 이러한 플래그에 대한 자세한 내용은 비고를 참조하세요.

이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값 참조하세요.

반환 코드	묘사
S_OK	메서드가 성공했습니다.

이 메서드는 라이브 사용자 모드 디버깅에만 사용할 수 있습니다.

참고WaitForEvent 메서드가 호출될 때까지 엔진이 프로세스에 완전히 연결되지 않습니다. 프로세스에서 이벤트를 생성한 후에만(예: create-process 이벤트) 디버거 세션에서 사용할 수 있게 됩니다.

라이브 사용자 모드 대상을 만들고 연결하는 방법에 대한 자세한 내용은 Live User-Mode 대상참조하세요.

DEBUG_ATTACH_XXX 비트 플래그는 디버거 엔진이 사용자 모드 프로세스에 연결할 방법을 제어합니다. 커널 대상에 연결할 때 사용되는 DEBUG_ATTACH_XXX 옵션은 AttachKernel참조하세요.

다음 표에서는 가능한 플래그 값을 설명합니다.

상수	묘사
DEBUG_ATTACH_NONINVASIVE	대상에 비침용적으로 연결합니다. 비침범성 디버깅에 대한 자세한 내용은 비침범성 디버깅(사용자 모드)참조하세요. 이 플래그가 설정되면 플래그 DEBUG_ATTACH_EXISTING, DEBUG_ATTACH_INVASIVE_NO_INITIAL_BREAK 및 DEBUG_ATTACH_INVASIVE_RESUME_PROCESS 설정하면 안 됩니다.
DEBUG_ATTACH_EXISTING	디버거가 이미 연결되어 있고 중단되었을 수 있는 애플리케이션에 다시 연결합니다. 대상에 다시 연결하는 방법에 대한 자세한 내용은 대상 애플리케이션 다시 연결하는참조하세요. 이 플래그가 설정되면 다른 DEBUG_ATTACH_XXX 플래그를 설정해서는 안 됩니다.
DEBUG_ATTACH_NONINVASIVE_NO_SUSPEND	비침약적으로 연결할 때 대상의 스레드를 일시 중단하지 마세요. 이 플래그를 설정하면 DEBUG_ATTACH_NONINVASIVE 플래그도 설정해야 합니다.
DEBUG_ATTACH_INVASIVE_NO_INITIAL_BREAK	(Windows XP 이상) 대상에 연결할 때 초기 침입을 요청하지 마세요. 이 플래그를 설정하면 플래그가 DEBUG_ATTACH_NONINVASIVE DEBUG_ATTACH_EXISTING 설정하면 안 됩니다.
DEBUG_ATTACH_INVASIVE_RESUME_PROCESS	이 플래그를 설정하면 플래그가 DEBUG_ATTACH_NONINVASIVE DEBUG_ATTACH_EXISTING 설정하면 안 됩니다.