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

  • 아티클

CreateProcessAndAttach2 메서드는 지정된 명령줄에서 프로세스를 만든 다음 해당 프로세스 또는 다른 사용자 모드 프로세스에 연결합니다.

구문

HRESULT CreateProcessAndAttach2(
  [in]           ULONG64 Server,
  [in, optional] PSTR    CommandLine,
  [in]           PVOID   OptionsBuffer,
  [in]           ULONG   OptionsBufferSize,
  [in, optional] PCSTR   InitialDirectory,
  [in, optional] PCSTR   Environment,
  [in]           ULONG   ProcessId,
  [in]           ULONG   AttachFlags
);

매개 변수

[in] Server

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

[in, optional] CommandLine

새 프로세스를 만들기 위해 실행할 명령줄을 지정합니다. CommandLine이 NULL이면 프로세스가 만들어지지 않으며 이러한 메서드는 ProcessId를 사용하여 기존 프로세스에 연결합니다.

[in] OptionsBuffer

프로세스 만들기 옵션을 지정합니다. OptionsBuffer 는 DEBUG_CREATE_PROCESS_OPTIONS 구조체에 대한 포인터입니다.

[in] OptionsBufferSize

버퍼 옵션 버퍼의 크기를 지정합니다. sizeof(DEBUG_CREATE_PROCESS_OPTIONS)로 설정해야 합니다.

[in, optional] InitialDirectory

프로세스의 시작 디렉터리를 지정합니다. 이 매개 변수는 CommandLine 이 NULL이 아닌 경우에만 사용됩니다. InitialDirectory가 NULL이면 프로세스 서버의 현재 디렉터리가 사용됩니다.

[in, optional] Environment

새 프로세스에 대한 환경 블록을 지정합니다. 환경 블록은 null로 종료된 null로 끝나는 문자열 블록으로 구성됩니다. 각 문자열은 다음과 같은 형식입니다.

name=value

환경 블록의 마지막 두 문자는 모두 NULL입니다. 하나는 문자열을 종료하고 다른 하나는 블록을 종료합니다.

환경이 NULL로 설정된 경우 새 프로세스는 프로세스 서버의 환경 블록을 상속합니다. DEBUG_CREATE_PROCESS_THROUGH_RTL 플래그가 OptionsBuffer에 설정된 경우 환경 은 NULL이어야 합니다.

[in] ProcessId

디버거가 연결할 대상 프로세스의 프로세스 ID를 지정합니다. ProcessID가 0이면 디버거가 CommandLine에서 만든 프로세스에 연결됩니다.

[in] AttachFlags

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

반환 값

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

반환 코드 Description
S_OK
 메서드를 성공적으로 수행했습니다.
E_INVALIDARG
 CommandLine이 NULL이고 ProcessId가 0이면 반환됩니다.

설명

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

CommandLine이 NULL이 아니고 ProcessId가 0이 아닌 경우 엔진은 일시 중단된 상태로 프로세스를 만듭니다. 엔진은 ProcessId에 지정된 프로세스에 성공적으로 연결한 후 새로 만든 이 프로세스를 다시 시작합니다.

참고WaitForEvent 메서드가 호출될 때까지 엔진이 프로세스에 완전히 연결되지 않습니다. 프로세스에서 이벤트를 생성한 후에만(예: create-process 이벤트) 디버거 세션에서 사용할 수 있게 됩니다.
 
라이브 사용자 모드 대상을 만들고 연결하는 방법에 대한 자세한 내용은 라이브 User-Mode 대상을 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 dbgeng.h(Dbgeng.h 포함)

추가 정보

.attach(프로세스에 연결)

.create(프로세스 만들기)

AbandonCurrentProcess

AttachProcess

ConnectProcessServer

CreateProcess2

DetachCurrentProcess

GetRunningProcessDescription

GetRunningProcessSystemIds

IDebugClient5

TerminateCurrentProcess