pdcomm_gem_equipment_configure_reports
함수
지정한 수집 이벤트(collection event)로 장비에 빈 보고서 저장소를 설치합니다.
PdcommStatus pdcomm_gem_equipment_configure_reports(PdcommTcpEndpoint *endpoint, const PdcommGemReportOptions *options, const uint32_t *event_ids, size_t count)이벤트 ID는 순서대로 복사되며, 모든 이벤트는 링크 없이 비활성 상태로 시작합니다. 저장소는 TCP 엔드포인트가 Stopped 상태인 동안 엔드포인트마다 한 번만 구성할 수 있습니다. 이전에 구성한 알람, 명령, 이벤트 디렉터리 구성 중 수집 이벤트를 참조하는 것은 새 저장소를 기준으로 검증합니다. 실패하면 장비는 바뀌지 않습니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | pdcomm_gem_configure_equipment()로 구성한 장비 엔드포인트입니다. |
options | 저장소 한도입니다. struct_size는 sizeof(PdcommGemReportOptions) 이상, version은 #PDCOMM_GEM_REPORT_OPTIONS_VERSION, reserved는 0이어야 합니다. |
event_ids | count개의 CEID 배열이며 값은 서로 달라야 합니다. count가 0이면 NULL일 수 있습니다. |
count | 이벤트 ID 개수입니다. 최대 options->max_events입니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 options가 NULL이거나, 옵션이 유효하지 않거나, count가 0이 아닌데 event_ids가 NULL이거나, 이벤트 ID가 중복되면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. count가 max_events를 넘거나 배열 크기가 오버플로하면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 엔드포인트가 Stopped 상태가 아니거나, 준비된 TCP 이벤트(staged event)가 있거나, 장비가 아니거나, 이미 보고서 저장소가 있거나, GEM 통신이 활성 상태이면 #PDCOMM_INVALID_STATE를 반환합니다. 기존 알람, 명령, 디렉터리 구성이 event_ids에 없는 이벤트를 가리키면 #PDCOMM_INVALID_DATA를 반환합니다. 그 밖에 #PDCOMM_ALLOCATION_FAILED 또는 #PDCOMM_POISONED를 반환합니다.
참고
- 스레드 안전성:
endpoint에 대한 다른 모든 호출과 직렬화합니다.