pdcomm_gem_result_program_item
함수
프로그램 결과에서 PPID 또는 PPBODY를 복사합니다.
PdcommStatus pdcomm_gem_result_program_item(const PdcommGemResult *result, uint32_t field, size_t index, PdcommSecsItem **out_item)index가id_count보다 작은 #PDCOMM_GEM_PROGRAM_ID는 요청 PPID 또는 S7F6이나 S7F20 응답의 PPID를 반환합니다.index가 0인 #PDCOMM_GEM_PROGRAM_BODY는 S7F3 요청 또는 S7F6 응답의 본문을 반환합니다. 알 수 없음 센티널(unknown sentinel)을 담은 S7F6이면 #PDCOMM_OK를 반환하고*out_item은 NULL입니다. 이는 저장된 빈 본문과 구별됩니다.
매개변수
| 이름 | 설명 |
|---|---|
result | 프로그램 요청 결과 또는 응답 결과입니다. |
field | #PDCOMM_GEM_PROGRAM_ID 또는 #PDCOMM_GEM_PROGRAM_BODY입니다. |
index | 0부터 시작하는 PPID 인덱스이며, 본문이면 0입니다. |
out_item | 새 항목을 받거나, 위에 설명한 경우에는 NULL을 받습니다. 먼저 NULL로 설정됩니다. NULL이 아니어야 합니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. out_item 또는 result가 NULL이거나 field를 알 수 없으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 결과에 프로그램 데이터가 없거나, 본문이 없는 종류에서 본문을 요청하면 #PDCOMM_INVALID_STATE를 반환합니다. index가 PPID 범위를 넘거나, 본문 요청에서 0이 아니면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 그 밖에 #PDCOMM_ALLOCATION_FAILED 또는 #PDCOMM_INTERNAL_ERROR를 반환할 수 있습니다.
참고
- 소유권: NULL이 아닌
*out_item은 pdcomm_secs_destroy()로 해제합니다.