프린터 관련 서비스
프린터 관련 서비스
로컬 프린터를 조회하거나, 프린터를 조작하는 기능들을 제공합니다.
서비스 리스트
| No. | 서비스명 | API명 | 비고 |
| 1 | 기본 프린터 조회 |
WinInfo.GetDefaultPrinter
|
|
| 2 | 전체 프린터 조회 |
WinInfo.GetPrinterList
|
|
| 3 | 기본 프린터 설정 |
WinInfo.SetDefaultPrinter
|
|
| 4 | 기본 설정 조회 |
WinInfo.GetPrinterDefaultSettings
|
default tray, default paper |
| 5 | 지원 트레이 리스트 조회 |
WinInfo.GetPrinterTrays
|
|
| 6 | 지원 용지 리스트 조회 |
WinInfo.GetPrinterPapers
|
|
| 7 | 상세 정보 조회 |
WinInfo.GetPrinterDetails
|
default settings, tray list, paper list |
서비스 상태 코드 리스트
본 서비스에서 공통으로 사용되는 서비스 상태코드 리스트에 대해 정의합니다.
이 상태 코드는 응답 JSON 메시지 중 return 또는 returnValue의 값에 해당합니다.
| 리턴코드 | 리턴 코드 내용 | 대상 서비스 | 비고 |
| -1 | 정의되지 않은 예외 | 공통 | Log 파일에서 내용 확인 필요 |
| 0 | 정상 | 공통 | - |
| 20 | 기본 프린터 변경 실패 | SetDefaultPrinter | 대상 프린터 없음 등 |
| 98 | 유효하지 않은 파라미터 |
공통 |
- |
기본프린터 조회 방법
Windows는 "프린터 및 스캐너"에서 설정된 기본 프린터를 확인할 수 있으며, 기본 프린터를 확인하기 위해서는 반드시 "Windows에서 내 기본 프린터를 관리 할 수 있도록 허용" 옵션을 꺼야한다.
1. 기본 프린터 조회
API명
- WinInfo.GetDefaultPrinter
정의
- Windows에 기본 프린터로 설정된 프린터의 이름을 획득합니다.
호출예시
{
"service": "WinInfo.GetDefaultPrinter",
"requestKey": "Random Request Key",
"param": {}
}응답예시
{
"service":"WinInfo.GetDefaultPrinter",
"requestKey":"호출시 사용한 Request Key",
"statusCode":"0000",
"return":{
"returnValue":0,
"name":"FAX"
}
}- returnValue
- 서비스 상태코드.
- name
- 현재 Windows에서 기본 프린터로 설정된 프린터 이름.
2. 전체 프린터 조회
API명
- WinInfo.GetPrinterList
정의
- Windows에 등록된 모든 프린터 리스트를 획득하고, 기본프린터 설정 여부를 획득합니다.
호출예시
{
"service": "WinInfo.GetPrinterList",
"requestKey": "Random Request Key",
"param": {}
}응답예시
{
"service":"WinInfo.GetPrinterList",
"requestKey":"호출시 사용한 Request Key",
"statusCode":"0000",
"return":{
"returnValue":0,
"list":[
{"name":"OneNote for Windows 10","isDefault":false},
{"name":"Send To OneNote 2016","isDefault":false},
{"name":"Microsoft XPS Document Writer","isDefault":false},
{"name":"Microsoft Print to PDF","isDefault":false},
{"name":"Fax","isDefault":true}
]
}
}- returnValue
- 서비스 상태 코드.
- list: Windows에 등록된 프린터 리스트.
- name: 프린터 이름.
- isDefault: 기본 프린터 여부.
3. 기본 프린터 설정
API명
- WinInfo.SetDefaultPrinter
정의
- 지정한 프린터를 Windows의 기본 프린터로 설정합니다.
호출예시
{
"service":"WinInfo.SetDefaultPrinter",
"requestKey":"Random Request Key",
"param":{
"name":"OneNote for Windows 10"
}
}- name
- Windows 기본 프린터로 설정하고자 하는 프린터 이름.
응답예시
{
"service":"WinInfo.SetDefaultPrinter",
"requestKey":"호출시 사용한 Request Key",
"statusCode":"0000",
"return":0
}4. 기본 설정 조회
API명
- WinInfo.GetPrinterDefaultSettings
정의
- 프린터의 기본 값으로 설정된 트레이 ID와 용지 ID를 획득합니다.
호출예시
{
"service":"WinInfo.GetPrinterDefaultSettings",
"requestKey":"Random Request Key",
"param":{
"name": "FUJIFILM Apeos C2560"
}
}- name: 프린터 이름
프린터의 이름은 "전체 프린터 조회" 기능을 통해 확인할 수 있습니다.
응답예시
{
"service":"WinInfo.GetPrinterDefaultSettings",
"requestKey":"호출시 사용한 Request Key",
"statusCode":"0000",
"return":{
"returnValue":0,
"defSettings":{
"paper":{"width":2100,"height":2970,"kind":9},
"tray":{"kind":15}
}
}
}- returnValue
- 서비스 상태 코드.
- defSetting: 프린터 기본 설정 정보.
-
- paper: 기본 용지 설정.
- width: 용지 너비.
- height: 용지 높이.
- kind: 용지 식별 넘버.
- tray: 기본 트레이 설정
- kind: 트레이 식별 넘버.
- paper: 기본 용지 설정.
-
본 서비스는 용지의 이름과 트레이의 이름을 리턴하지 않고 식별ID(Kind)를 리턴합니다. 용지와 트레이 ID로 각각의 이름을 획득하려면 WinInfo.GetPrinterPapers 및 WinInfo.GetPrinterTrays를 사용하길 바랍니다.
5. 지원 트레이 리스트 조회
API명
- WinInfo.GetPrinterTrays
정의
- 프린터에서 지원하는 트레이 ID와 명칭을 획득합니다.
호출예시
{
"service":"WinInfo.GetPrinterTrays",
"requestKey":"Random Request Key",
"param":{
"name": "FUJIFILM Apeos C2560"
}
}- name: 프린터 이름
프린터의 이름은 "전체 프린터 조회" 기능을 통해 확인할 수 있습니다.
응답예시
{
"service":"WinInfo.GetPrinterTrays",
"requestKey":"호출시 사용한 Request Key",
"statusCode":"0000",
"return":{
"returnValue":0,
"trays":[
{"name":"자동","kind":15},
{"name":"자동선택","kind":7},
{"name":"트레이 1","kind":1},
{"name":"트레이 5(수동)","kind":4}
]
}
}- returnValue
- 서비스 상태 코드.
- trays: 프린터 지원 트레이 이름 및 ID 리스트.
- name: 트레이 식별 이름.
- kind: 트레이 식별 ID.
6. 지원 용지 리스트 조회
API명
- WinInfo.GetPrinterPapers
정의
- 프린터에서 지원하는 용지 ID와 명칭을 획득합니다.
호출예시
{
"service":"WinInfo.GetPrinterPapers",
"requestKey":"Random Request Key",
"param":{
"name": "FUJIFILM Apeos C2560"
}
}- name: 프린터 이름
프린터의 이름은 "전체 프린터 조회" 기능을 통해 확인할 수 있습니다.
응답예시
{
"service":"WinInfo.GetPrinterPapers",
"requestKey":"호출시 사용한 Request Key",
"statusCode":"0000",
"return":{
"returnValue":0,
"papers":[
{"name":"A1(594x841mm)","width":594,"height":841,"kind":0},
{"name":"A2(420x594mm)","width":420,"height":594,"kind":66},
{"name":"A3(297x420mm)","width":297,"height":420,"kind":8},
{"name":"B4(257x364mm)","width":257,"height":364,"kind":12},
{"name":"A4(210x297mm)","width":210,"height":297,"kind":9}
]
}
}- returnValue
- 서비스 상태 코드.
- papers: 프린터 지원 용지 이름 및 ID 리스트.
- name: 용지 식별 이름.
- width: 용지 가로 길이. (단위: mm)
- height: 용지 세로 길이. (단위: mm)
- kind: 용지식별 ID.
7. 상세 정보 조회
API명
- WinInfo.GetPrinterDetails
정의
- 프린터의 다음 상세 정보를 조회합니다.
- 기본 트레이, 용지 설정
- 지원하는 트레이 리스트
- 지원하는 용지 리스트
호출예시
{
"service":"WinInfo.GetPrinterDetails",
"requestKey":"Random Request Key",
"param":{
"name": "FUJIFILM Apeos C2560"
}
}- name: 프린터 이름
프린터의 이름은 "전체 프린터 조회" 기능을 통해 확인할 수 있습니다.
응답예시
{
"service":"WinInfo.GetPrinterDetails",
"requestKey":"호출시 사용한 Request Key",
"statusCode":"0000",
"return":{
"returnValue":0,
"details":{
"name":"FUJIFILM Apeos C2560(5층)",
"isDefault":true,
"defSettings":{
"paper":{"name":"A4(210x297mm)","width":210,"height":297,"kind":9},
"tray":{"name":"자동","kind":15}},
"trays":[
{"name":"자동","kind":15},
{"name":"자동선택","kind":7},
{"name":"트레이 1","kind":1},
{"name":"트레이 5(수동)","kind":4}
],
"papers":[
{"name":"A1(594x841mm)","width":594,"height":841,"kind":0},
{"name":"A2(420x594mm)","width":420,"height":594,"kind":66},
{"name":"A3(297x420mm)","width":297,"height":420,"kind":8},
{"name":"B4(257x364mm)","width":257,"height":364,"kind":12},
{"name":"A4(210x297mm)","width":210,"height":297,"kind":9}
]
}
}
}- returnValue
- 서비스 상태 코드.
- details: 상세정보.
- name: 프린터 이름.
- isDefault: 기본 프린터 여부.
- defSettings: 프린터 기본 설정.
- paper: 기본 용지 설정.
- name: 용지 식별 명칭.
- width: 용지 가로 길이. (단위: mm)
- height: 용지 세로 길이. (단위: mm)
- kind: 용지 식별 ID.
- tray: 기본 트레이 설정.
- name: 트레이 식별 명칭.
- kind: 트레이 식별 ID.
- paper: 기본 용지 설정.
- trays: 프린터 지원 트레이 이름 및 ID 리스트.
- name: 트레이 식별 이름.
- kind: 트레이 식별 ID.
- papers: 프린터 지원 용지 이름 및 ID 리스트.
- name: 용지 식별 이름.
- width: 용지 가로 길이. (단위: mm)
- height: 용지 세로 길이. (단위: mm)
- kind: 용지식별 ID.
댓글 없음