pdcomm_secs_list
함수
기존 항목의 사본으로 List 항목을 만듭니다.
PdcommStatus pdcomm_secs_list(const PdcommSecsItem *const *children, size_t count, const PdcommSecsLimits *options, PdcommSecsItem **out)자식을 복사하기 전에 새 List의 전체 크기, 항목 개수, 깊이를 options로 검사합니다. 자식 핸들의 소유권은 호출자에게 남으며 변경되지 않습니다.
매개변수
| 이름 | 설명 |
|---|---|
children | 유효한 항목 핸들 count개의 배열입니다. count가 0이면 NULL일 수 있으며, 이 경우 빈 List를 만듭니다. 어떤 요소도 NULL이면 안 됩니다. |
count | 자식 개수입니다. options->item_count보다 작고 최대 16777215여야 합니다. |
options | 적용할 한도입니다. struct_size는 sizeof(PdcommSecsLimits) 이상이어야 합니다. |
out | 새 List를 받습니다. 실패하면 항상 NULL입니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. out 또는 options가 NULL이거나, options->struct_size가 너무 작거나, count가 0이 아닌데 children이 NULL이거나, 자식 핸들이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. List나 어떤 자식이 한도를 넘으면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 그 밖에 #PDCOMM_ALLOCATION_FAILED 또는 #PDCOMM_INTERNAL_ERROR를 반환합니다.
참고
- 소유권: pdcomm_secs_destroy()로 List를 해제합니다. 나중에 자식 핸들을 해제해도 List에는 영향이 없습니다.