프로세스 제어 관련 서비스

 본 서비스는 시스템에서 실행 중인 특정 프로세스 또는 특정 프로세스의 창을 조작하기 위한 기능을 지원합니다.

서비스 리스트

 프로세스 제어 관련 서비스 리스트는 다음과 같습니다.

No. 서비스명 API명 비고
1 타이틀 기반 프로세스 구동 체크 CheckProcessRunningByTitle
2 PID 기반 프로세스 구동 체크 CheckProcessRunningByPID
3 타이틀 기반 특정 프로세스 창 이동 SetWindowPosition
4 타이틀 기반 특정 프로세스 창 최상단 배치 BringWindowToTop
5 PID 기반 특정 프로세스 창 이동 SetProcessWindowPosition
6 프로세스 IME 모드 변경 WinInfo.SetImeMode

서비스 상태 코드 리스트

 본 서비스에서 공통으로 사용되는 서비스 상태코드 리스트에 대해 정의합니다.

 이 상태 코드는 응답 JSON 메시지 중 return 또는 returnValue의 값에 해당합니다.

리턴코드 리턴 코드 내용 대상 서비스 비고
-1 정의되지 않은 예외 공통 Log 파일에서 내용 확인 필요
0 정상 공통 -
2 PC와 연결된 모니터 리스트 획득 실패

SetWindowPosition,

SetProcessWindowPosition

 -
3 요청 모니터 정보 획득 실패

SetWindowPosition,

SetProcessWindowPosition

 -
4 모니터 해상도 획득 실패

SetWindowPosition,

SetProcessWindowPosition

 -
5 지원하지 않는 창 크기 설정 옵션

SetWindowPosition,

SetProcessWindowPosition

 -
6 대상 타이틀을 가진 프로세스가 없음

SetWindowPosition,

BringWindowToTop,

SetProcessWindowPosition,

SetImeMode

 -
16 지원되지 않는 프로세스

SetImeMode, GetImeMode

 -
17 IME 접근 권한이 없는 프로세스

SetImeMode, GetImeMode

 -
18 IME 핸들 획득 실패

SetImeMode, GetImeMode

 -
19 IME 변경 실패

SetImeMode, GetImeMode

 -

1. 타이틀 기반 프로세스 구동 체크

API명

정의

호출예시

{
  "service":"WinInfo.CheckProcessRunningByTitle",
  "requestKey":"Random Request Key",
  "param":{ 
    "processTitle":"TOMATO SYSTEM"
  }
}

응답예시

{
  "service":"WinInfo.CheckProcessRunningByTitle",
  "requestKey":"976a-75cf-5b52",
  "statusCode":"0000",
  "return":{
    "returnValue":0,
    "isRunning":true
  }
}

2. PID 기반 프로세스 구동 체크

API명

정의

호출예시

{
  "service": "WinInfo.CheckProcessRunningByPID",
  "requestKey": "Random Request Key",
  "param": { 
    "processId": "28700"
  }
}

응답예시

{
  "service":"WinInfo.CheckProcessRunningByTitle",
  "requestKey":"976a-75cf-5b52",
  "statusCode":"0000",
  "return":{
    "returnValue":0,
    "isRunning":true
  }
}

3. 타이틀 기반 특정 프로세스 창 이동

API명

정의

모니터와 관련된 정보는 "모니터 관련 서비스" 문서를 참고하시길 바랍니다.

설명

K-018.png

<Windows 모니터 및 프로세스 창 해상도 식별 방식>

호출예시

{
  "service": "WinInfo.SetWindowPosition",
  "requestKey": "Random Request Key",
  "param": { 
    "processTitle": "TOMATOSYSTEM",
    "screenIndex": 1,
    "screenSizeMode": 1,
    "left": 0,
    "top": 0,
    "width": 900,
    "height": 800
  }
}

응답예시

{
  "service":"WinInfo.SetWindowPosition",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":0
}

4. 타이틀 기반 특정 프로세스 창 최상단 배치

API명

정의

호출예시

{
  "service": "WinInfo.BringWindowToTop",
  "requestKey": "Random Request Key",
  "param": { 
    "processTitle": "TOMATOSYSTEM"
  }
}

응답예시

{
  "service":"WinInfo.BringWindowToTop",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":0
}

5. PID 기반 특정 프로세스 창 이동

API명

정의

모니터와 관련된 정보는 "모니터 관련 서비스" 문서를 참고하시길 바랍니다.

설명

K-018.png

<Windows 모니터 및 프로세스 창 해상도 식별 방식>

호출예시

{
  "service": "WinInfo.SetProcessWindowPosition",
  "requestKey": "Random Request Key",
  "param": { 
    "processId": "28700",
    "screenIndex": 1,
    "screenSizeMode": 1,
    "left": 0,
    "top": 0,
    "width": 900,
    "height": 800
  }
}

응답예시

{
  "service":"WinInfo.SetProcessWindowPosition",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":0
}

6. 프로세스 IME 모드 변경

API명

정의

호출예시

{
  "service": "WinInfo.SetImeMode",
  "requestKey": "Random Request Key",
  "param": { 
    "toNative": true
  }
}

응답예시

{
  "service":"WinInfo.SetImeMode",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":0
}

7. 프로세스 IME 모드 획득

API명

정의

호출예시

{
  "service": "WinInfo.GetImeMode",
  "requestKey": "Random Request Key",
  "param": {}
}

응답예시

{
  "service":"WinInfo.GetImeMode",
  "requestKey":"호출시 사용한 Request Key",
  "statusCode":"0000",
  "return":{
    "returnValue":0,
    "isNative":true
  }
}

버전 #10