IDebugClient5::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 |
---|---|
|
메서드를 성공적으로 수행했습니다. |
|
둘 이상의 프로세스가 ExeName의 실행 파일 이름과 일치했으며 DEBUG_GET_PROC_ONLY_MATCH Flags에서 설정되었습니다. |
|
ExeName의 실행 파일 이름과 일치하는 프로세스가 없습니다. |
설명
이 메서드는 라이브 사용자 모드 디버깅에만 사용할 수 있습니다.
라이브 사용자 모드 대상을 만들고 연결하는 방법에 대한 자세한 내용은 라이브 User-Mode 대상을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 데스크톱 |
머리글 | dbgeng.h(Dbgeng.h 포함) |