pdcomm_gem_equipment_directory_get
함수
로컬 이벤트 디렉터리 엔트리 하나의 이름 또는 VID를 복사합니다.
PdcommStatus pdcomm_gem_equipment_directory_get(PdcommTcpEndpoint *endpoint, uint32_t id, uint32_t field, PdcommSecsItem **out_item)#PDCOMM_GEM_DIRECTORY_NAME은 소유한 ASCII 항목을, #PDCOMM_GEM_DIRECTORY_VARIABLE_IDS는 소유한 U4 배열 항목을 반환합니다. 이벤트 엔트리에는 #PDCOMM_GEM_DIRECTORY_UNITS를 사용할 수 없습니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 장비 엔드포인트입니다. |
id | 엔트리의 CEID입니다. |
field | #PDCOMM_GEM_DIRECTORY_NAME 또는 #PDCOMM_GEM_DIRECTORY_VARIABLE_IDS입니다. |
out_item | 새 항목을 받습니다. 먼저 NULL로 설정됩니다. NULL이 아니어야 합니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 out_item이 NULL이거나 field를 받아들일 수 없으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. id가 디렉터리에 없으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 엔드포인트가 장비가 아니거나 디렉터리가 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 그 밖에 #PDCOMM_BACKPRESSURE, #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, #PDCOMM_POISONED를 반환합니다.
참고
- 소유권: pdcomm_secs_destroy()로 항목을 해제합니다. 항목은 재구성 뒤에도 남습니다.