IDebugClient2::GetRunningProcessSystemIdByExecutableName 메서드(dbgeng.h)

GetRunningProcessSystemIdByExecutableName 메서드는 지정된 실행 파일 이름을 가진 프로세스를 검색하고 해당 프로세스 ID를 반환합니다.

구문

HRESULT GetRunningProcessSystemIdByExecutableName(
  [in]  ULONG64 Server,
  [in]  PCSTR   ExeName,
  [in]  ULONG   Flags,
  [out] PULONG  Id
);

매개 변수

[in] Server

실행 파일 이름을 검색할 프로세스 서버를 지정합니다. 서버가 0이면 엔진은 로컬 컴퓨터에서 실행되는 프로세스 중 실행 파일 이름을 검색합니다.

[in] ExeName

검색할 실행 파일 이름을 지정합니다.

[in] Flags

실행 파일 이름과 일치하는 방법을 제어하는 비트 집합을 지정합니다. 다음과 같은 플래그가 있을 수 있습니다.

플래그 설명
DEBUG_GET_PROC_FULL_MATCH ExeName 은 실행 파일 이름의 전체 경로 이름을 지정합니다.

이 플래그가 설정되지 않은 경우 이 메서드는 프로세스를 검색할 때 경로 이름을 사용하지 않습니다.

DEBUG_GET_PROC_ONLY_MATCH 실행 파일 이름 ExeName과 일치하는 프로세스는 하나만 필요합니다.

[out] Id

ExeName과 일치하는 첫 번째 프로세스의 프로세스 ID를 받습니다.

반환 값

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

반환 코드 Description
S_OK
메서드를 성공적으로 수행했습니다.
S_FALSE
둘 이상의 프로세스가 ExeName의 실행 파일 이름과 일치하고 DEBUG_GET_PROC_ONLY_MATCH Flags에 설정되었습니다.
E_NOINTERFACE
ExeName의 실행 파일 이름과 일치하는 프로세스가 없습니다.

설명

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

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

요구 사항

   
대상 플랫폼 데스크톱
헤더 dbgeng.h(Dbgeng.h 포함)

참고 항목

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessDescription

GetRunningProcessSystemIds

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5