pdcomm_gem_formatted_program_execution_cancel
함수
실행 취소를 Cancel 동작으로 요청합니다.
PdcommStatus pdcomm_gem_formatted_program_execution_cancel(PdcommTcpEndpoint *endpoint, const PdcommGemFormattedProgramExecutionToken *execution_token, PdcommGemFormattedProgramExecutionActionHandle **out_action)RUNNING 상태에서 호출할 수 있으며, 상태가 CANCEL_PENDING이 됩니다. CANCEL_PENDING 상태에서는 대기 중인 Cancel 동작을 다시 반환합니다. 취소하기 전에 대기 중인 Start 또는 Step 동작을 먼저 처리합니다. 연결은 필요하지 않습니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 정형 프로그램 조회가 구성된 장비 엔드포인트입니다. |
execution_token | 현재 실행의 토큰입니다. |
out_action | Cancel 동작을 받습니다. endpoint가 유효하고 오염(poisoned) 상태가 아니면 먼저 NULL로 설정되므로, 이후의 모든 실패에서 NULL입니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. 포인터가 NULL이거나 토큰의 크기, 버전, 예약 필드가 유효하지 않으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 토큰이 현재 실행을 가리키지 않으면 #PDCOMM_STALE_TOKEN을 반환합니다. 실행 추적을 사용할 수 없거나 상태가 RUNNING 또는 CANCEL_PENDING이 아니면 #PDCOMM_INVALID_STATE를 반환합니다. 동작 이력 또는 순번 카운터가 소진되면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 엔드포인트에 준비된 TCP 이벤트(staged event)가 있으면 #PDCOMM_BACKPRESSURE를 반환합니다. 그 밖에 #PDCOMM_ALLOCATION_FAILED와 #PDCOMM_POISONED를 반환할 수 있습니다.
참고
- 소유권: pdcomm_gem_formatted_program_execution_action_destroy()로 동작(action)을 해제합니다.