pdcomm_gem_formatted_program_clear_selection
함수
토큰이 현재 선택과 일치하면 선택을 해제합니다.
PdcommStatus pdcomm_gem_formatted_program_clear_selection(PdcommTcpEndpoint *endpoint, const PdcommGemFormattedProgramSelectionToken *token, uint8_t *out_cleared)무효(stale) 상태인 선택도 해제할 수 있습니다. 선택된 것이 없을 때 모두 0인 토큰(헤더는 유효)을 전달하면 *out_cleared = 0으로 성공합니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 정형 프로그램 조회 서비스가 구성된 장비 엔드포인트입니다. |
token | 현재 선택의 토큰입니다. |
out_cleared | 선택을 해제했으면 1, 아니면 0을 받습니다. token과 out_cleared가 유효하면 0으로 설정됩니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. endpoint, token 또는 out_cleared가 NULL이거나 토큰 헤더가 유효하지 않으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 토큰이 현재 선택과 일치하지 않거나, 선택된 것이 없는데 토큰이 모두 0이 아니면 #PDCOMM_STALE_TOKEN을 반환합니다. 엔드포인트가 장비가 아니거나 조회 서비스가 구성되지 않았으면 #PDCOMM_INVALID_STATE를 반환합니다. 선택 리비전이 소진되면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 준비된 TCP 이벤트(staged event)를 먼저 비워야 하면 #PDCOMM_BACKPRESSURE를 반환합니다. 엔드포인트가 오염(poisoned) 상태이면 #PDCOMM_POISONED를 반환합니다.
참고
- 스레드 안전성:
endpoint에 대한 다른 모든 호출과 직렬화합니다.