pdcomm::startFormattedProgramExecution
함수
선택된 프로그램의 실행을 시작하고 그 시작 동작을 반환합니다.
inline GemFormattedProgramExecutionStart startFormattedProgramExecution(GemEquipment &endpoint, const GemFormattedProgramSelectionToken &selection, const GemFormattedProgramDryRunReport &report)선택(selection)은 여전히 준비(ready) 상태여야 합니다. report는 그 선택에 대한 시험 실행(dry run) 보고서여야 하고, 기능 카탈로그(capability catalog)가 바뀌지 않았으며 결과가 거부(reject)가 아니어야 합니다. 활성 실행은 하나만 있을 수 있습니다. 시작이 대기 중일 때 같은 선택과 보고서로 다시 호출하면 같은 시작 동작을 반환합니다. 라이브러리는 장비 입출력을 수행하지 않습니다. 애플리케이션이 시작 동작의 결과를 확정할 때까지 상태는 ..._START_PENDING입니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 정형 프로그램 요청이 구성된 장비 끝점(endpoint)입니다. |
selection | selectFormattedProgram()이 반환한 토큰입니다. |
report | 그 선택에 대한 시험 실행(dry-run) 보고서입니다. |
반환값
실행 토큰과 시작 동작입니다.
참고
- 예외
pdcomm::Error: 다른 실행이 활성 상태이거나, 시험 실행이 프로그램을 거부했거나, 세션 연결이 끊겼으면PDCOMM_INVALID_STATE, 선택, 기능 카탈로그, 정책 또는 프로그램이 더 이상 일치하지 않으면PDCOMM_STALE_TOKEN, 실행 한도를 넘으면PDCOMM_LIMIT_EXCEEDED입니다.