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

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

구문

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

[in] Server

실행 파일 이름을 검색할 프로세스 서버를 지정합니다. 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의 실행 파일 이름과 일치하는 프로세스가 없습니다.