pdcomm_gem_formatted_program_execution_submit_action_result
함수
대기 중인 동작에 대한 애플리케이션의 결과를 보고합니다.
PdcommStatus pdcomm_gem_formatted_program_execution_submit_action_result(PdcommTcpEndpoint *endpoint, const PdcommGemFormattedProgramExecutionActionToken *action_token, uint32_t result)동작 종류별로 유효한 결과는 다음과 같습니다.
- Start: ACCEPTED, REJECTED, FAILED, OUTCOME_UNKNOWN.
- Step: APPLIED, REJECTED, FAILED, OUTCOME_UNKNOWN.
- Cancel: CANCELLED, REJECTED, FAILED, OUTCOME_UNKNOWN.
이미 처리된 동작에 같은 결과를 다시 보고하면 상태를 바꾸지 않고 성공합니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 정형 프로그램 조회가 구성된 장비 엔드포인트입니다. |
action_token | 동작의 ::PdcommGemFormattedProgramExecutionActionInfo로 만든 토큰입니다. |
result | PDCOMM_GEM_FORMATTED_PROGRAM_EXECUTION_ACTION_RESULT_* 값 중 하나입니다. |
반환값
성공하거나 동일한 내용을 반복하면 #PDCOMM_OK를 반환합니다. endpoint 또는 action_token이 NULL이거나, 토큰의 크기, 버전, 종류, 예약 필드가 유효하지 않거나, result를 알 수 없거나, result가 동작 종류에 유효하지 않으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 토큰이 현재 실행이나 그 대기 중인 동작을 가리키지 않거나, 해당 동작에 다른 결과가 이미 보고되었으면 #PDCOMM_STALE_TOKEN을 반환합니다. 실행 추적을 사용할 수 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 카운터가 오버플로하면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 엔드포인트에 준비된 TCP 이벤트(staged event)가 있으면 #PDCOMM_BACKPRESSURE를 반환합니다. 그 밖에 #PDCOMM_POISONED를 반환할 수 있습니다.