pdcomm_gem_equipment_status_get

함수

등록된 상태 변수의 현재 값을 복사합니다.

PdcommStatus pdcomm_gem_equipment_status_get(PdcommTcpEndpoint *endpoint, uint32_t id, PdcommSecsItem **out_item)

선언 위치: #include <pdcomm_gem.h>

매개변수

이름	설명
`endpoint`	장비 역할을 가진 유효한 TCP 엔드포인트입니다.
`id`	등록된 상태 변수 ID입니다.
`out_item`	값의 사본을 소유하는 새 항목을 받습니다. 먼저 NULL로 설정되므로 실패하면 항상 NULL입니다. NULL이 아니어야 합니다.

반환값

성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 out_item이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. id가 등록되어 있지 않으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 엔드포인트에 장비 역할이 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 준비된 TCP 이벤트(staged event)가 있으면 #PDCOMM_BACKPRESSURE를 반환합니다. 그 밖에 #PDCOMM_ALLOCATION_FAILED 또는 #PDCOMM_POISONED를 반환합니다.

참고

소유권: pdcomm_secs_destroy()로 항목을 해제합니다. 항목은 엔드포인트가 해제된 뒤에도 유효합니다.