pdcomm_gem_equipment_constant_at
함수
위치로 지정한 상수 정의 하나와 그 ID를 읽습니다.
PdcommStatus pdcomm_gem_equipment_constant_at(PdcommTcpEndpoint *endpoint, size_t index, PdcommGemConstantInfo *info, PdcommSecsItem **out_id)상수는 정의 순서대로 열거됩니다. 엔드포인트를 검사하기 전에 *out_id를 NULL로 설정하고 info의 알려진 필드를 0으로 초기화합니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 장비 엔드포인트입니다. |
index | 0부터 시작하는 위치입니다. |
info | 호출자 저장 공간입니다. 먼저 info->struct_size를 설정합니다. |
out_id | 상수 ID를 새 항목으로 받습니다(숫자 ID는 I8 또는 U8로 정규화됩니다). NULL이 아니어야 하며 info와 겹치면 안 됩니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. 포인터가 NULL이거나, info가 너무 작거나, 출력이 겹치면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. index가 상수 개수보다 작지 않으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 엔드포인트가 장비가 아니거나 상수 저장소가 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 그 밖에 #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, #PDCOMM_POISONED를 반환합니다.
참고
- 소유권: pdcomm_secs_destroy()로
*out_id를 해제합니다.