IDebugEventCallbacks::CreateProcess 메서드(dbgeng.h)

CreateProcess 콜백 메서드는 대상에서 create-process 디버깅 이벤트가 발생할 때 엔진에서 호출됩니다.

구문

HRESULT CreateProcess(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 Handle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCSTR   ModuleName,
  [in, optional] PCSTR   ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp,
  [in]           ULONG64 InitialThreadHandle,
  [in]           ULONG64 ThreadDataOffset,
  [in]           ULONG64 StartOffset
);

매개 변수

[in] ImageFileHandle

프로세스의 이미지 파일에 대한 핸들을 지정합니다. 이 정보를 사용할 수 없는 경우 ImageFileHandle 은 NULL이 됩니다.

[in] Handle

프로세스에 대한 핸들을 지정합니다. 이 매개 변수는 CREATE_PROCESS_DEBUG_INFO 구조체의 hProcess 필드에 해당합니다. 이 정보를 사용할 수 없는 경우 ImageFileHandle 은 NULL이 됩니다.

[in] BaseOffset

대상의 메모리 주소 공간에서 프로세스 실행 이미지의 기본 주소를 지정합니다. 이 정보를 사용할 수 없는 경우 BaseOffset 은 NULL이 됩니다.

[in] ModuleSize

프로세스의 실행 파일 이미지 크기를 바이트 단위로 지정합니다. 이 정보를 사용할 수 없는 경우 ModuleSize 는 0이 됩니다.

[in, optional] ModuleName

디버거 엔진에서 사용하는 간소화된 모듈 이름을 지정합니다. 대부분의 경우 확장명을 제외한 이미지 파일 이름과 일치합니다. 이 정보를 사용할 수 없는 경우 ModuleName 은 NULL이 됩니다.

[in, optional] ImageName

경로를 포함할 수 있는 프로세스의 실행 파일 파일 이름을 지정합니다. 이 정보를 사용할 수 없는 경우 ImageName 은 NULL이 됩니다.

[in] CheckSum

프로세스 실행 파일 이미지의 체크섬을 지정합니다. 이 정보를 사용할 수 없는 경우 CheckSum 은 0이 됩니다.

[in] TimeDateStamp

프로세스의 executable-image 파일의 시간 및 날짜 스탬프를 지정합니다. 이 정보를 사용할 수 없는 경우 TimeDateStamp 는 0이 됩니다.

[in] InitialThreadHandle

프로세스의 초기 스레드에 대한 핸들을 지정합니다. 이 매개 변수는 CREATE_PROCESS_DEBUG_INFO 구조체의 hThread 필드에 해당합니다. 이 정보를 사용할 수 없는 경우 InitialThreadHandle 은 NULL이 됩니다.

[in] ThreadDataOffset

운영 체제에서 이 스레드에 대해 유지 관리하는 데이터 블록을 지정합니다. 블록의 실제 데이터는 운영 체제별로 다릅니다. 이 정보를 사용할 수 없는 경우 ThreadDataOffset 은 NULL이 됩니다.

[in] StartOffset

프로세스의 가상 주소 공간에서 스레드의 시작 주소를 지정합니다. 이 정보를 사용할 수 없는 경우 StartOffset 은 NULL이 됩니다.

반환 값

이 메서드는 엔진이 이 이벤트를 처리한 후 대상의 실행을 진행하는 방법을 나타내는 DEBUG_STATUS_XXX 값을 반환합니다. 엔진이 이 값을 처리하는 방법에 대한 자세한 내용은 이벤트 모니터링을 참조하세요.

설명

이 메서드는 IDebugEventCallbacks::GetInterestMask에서 반환된 마스크에서 DEBUG_EVENT_CREATE_PROCESS 플래그가 설정된 경우에만 엔진에서 호출됩니다.

이벤트 처리에 대한 자세한 내용은 이벤트 모니터링을 참조하세요. 스레드에 대한 자세한 내용은 스레드 및 프로세스를 참조하세요.

요구 사항

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