pdcomm_gem_result_directory_get
함수
검증을 마친 S1F22 또는 S1F24 응답에서 엔트리 하나의 필드 하나를 복사합니다.
PdcommStatus pdcomm_gem_result_directory_get(const PdcommGemResult *result, size_t index, uint32_t field, PdcommSecsItem **out_item)데이터 변수 엔트리는 #PDCOMM_GEM_DIRECTORY_NAME과 #PDCOMM_GEM_DIRECTORY_UNITS(ASCII 항목)를 받아들입니다. 이벤트 엔트리는 #PDCOMM_GEM_DIRECTORY_NAME(ASCII 항목)과 #PDCOMM_GEM_DIRECTORY_VARIABLE_IDS(U4 배열 항목 하나)를 받아들입니다.
매개변수
| 이름 | 설명 |
|---|---|
result | 결과 유형이 #PDCOMM_GEM_DATA_DIRECTORY_RECEIVED 또는 #PDCOMM_GEM_EVENT_DIRECTORY_RECEIVED인 결과입니다. |
index | 0부터 시작하는 엔트리 위치입니다. |
field | 엔트리 유형에 유효한 필드 선택자입니다. |
out_item | 새 항목을 받습니다. 먼저 NULL로 설정됩니다. NULL이 아니어야 합니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. result 또는 out_item이 NULL이거나 field가 엔트리 유형에 맞지 않으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. result가 유효하지 않거나, 실패했거나, 관련 없는 결과이면 #PDCOMM_INVALID_STATE를 반환합니다. index가 엔트리 개수보다 작지 않으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 그 밖에 #PDCOMM_INVALID_DATA, #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, #PDCOMM_INTERNAL_ERROR를 반환합니다.
참고
- 소유권: pdcomm_secs_destroy()로 항목을 해제합니다.