pdcomm_gem_equipment_constant_get
함수
로컬 상수의 필드 하나를 복사합니다.
PdcommStatus pdcomm_gem_equipment_constant_get(PdcommTcpEndpoint *endpoint, const PdcommSecsItem *id, uint32_t field, PdcommSecsItem **out_item)선택 사항인 기본값, 최솟값, 최댓값이 없으면 #PDCOMM_OK를 반환하고 *out_item은 NULL입니다. 이는 빈 ASCII 값과 구별됩니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 장비 엔드포인트입니다. |
id | 찾을 상수 ID 항목(ASCII 또는 요소가 하나인 정수)입니다. |
field | #PDCOMM_GEM_CONSTANT_ID부터 #PDCOMM_GEM_CONSTANT_CURRENT까지의 값입니다. |
out_item | 새 항목 또는 NULL을 받습니다. 먼저 NULL로 설정됩니다. NULL이 아니어야 합니다. |
반환값
성공하면 #PDCOMM_OK를 반환하며, 선택 값이 없는 경우도 포함합니다. 포인터가 NULL이거나, field를 알 수 없거나, id가 유효한 상수 ID가 아니면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. id가 정의되지 않았으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 엔드포인트가 장비가 아니거나 상수 저장소가 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 그 밖에 #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, #PDCOMM_POISONED를 반환합니다.
참고
- 소유권: NULL이 아닌 항목은 pdcomm_secs_destroy()로 해제합니다.