pdcomm_gem_formatted_program_query_seed

함수

장비 저장소에 프로그램을 추가하거나 교체합니다(호환용 별칭).

PdcommStatus pdcomm_gem_formatted_program_query_seed(PdcommTcpEndpoint *endpoint, const PdcommSecsItem *id, const char *model, size_t model_length, const char *software_revision, size_t software_revision_length, const PdcommGemFormattedProgramQueryCommand *commands, size_t command_count)

선언 위치: #include <pdcomm_gem_formatted_program_queries.h>

장비 전용입니다. #PDCOMM_GEM_FORMATTED_PROGRAM_UPSERT를 지정한 pdcomm_gem_formatted_program_store_put()과 같지만 다음이 다릅니다. 모든 CCODE는 ASCII여야 하며, S7F26 응답으로 인코딩할 수 없는 프로그램은 #PDCOMM_INVALID_DATA를 보고합니다. 새 코드에서는 저장소 함수를 사용하는 것이 좋습니다.

매개변수

이름	설명
`endpoint`	이 서비스가 구성된 장비 엔드포인트입니다.
`id`	PPID: 최대 120바이트이며 비어 있지 않은 ASCII 또는 Binary 항목입니다.
`model`	MDLN: 최대 20바이트의 ASCII입니다. `model_length`가 0이면 NULL일 수 있습니다.
`model_length`	`model`의 길이(바이트)입니다.
`software_revision`	SOFTREV: 최대 20바이트의 ASCII입니다. `software_revision_length`가 0이면 NULL일 수 있습니다.
`software_revision_length`	`software_revision`의 길이(바이트)입니다.
`commands`	`command_count`개의 공정 명령 배열입니다. `command_count`가 0이면 NULL일 수 있습니다.
`command_count`	명령 개수입니다.

반환값

저장소에 프로그램이 들어 있으면 #PDCOMM_OK를 반환합니다. endpoint 또는 id가 NULL이거나, 필요한 배열 또는 항목 포인터가 NULL이거나, PPID, MDLN, SOFTREV 또는 CCODE가 유효하지 않으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 엔드포인트가 장비가 아니거나, 서비스가 구성되지 않았거나, 전송 응답이 저장소를 갱신하는 중이면 #PDCOMM_INVALID_STATE를 반환합니다. 명령 또는 매개변수 한도를 넘거나, 항목이 엔드포인트의 SECS-II 한도를 넘거나, 저장소 한도를 넘게 되면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 프로그램을 엔드포인트의 SECS-II 한도 안에서 S7F26 응답으로 인코딩할 수 없으면 #PDCOMM_INVALID_DATA를 반환합니다. 준비된 TCP 이벤트(staged event)를 먼저 비워야 하면 #PDCOMM_BACKPRESSURE를 반환합니다. #PDCOMM_ALLOCATION_FAILED를 반환할 수도 있습니다. 엔드포인트가 오염(poisoned) 상태이면 #PDCOMM_POISONED를 반환합니다.

참고

소유권: 모든 입력은 호출자가 계속 소유합니다.
스레드 안전성: endpoint에 대한 다른 모든 호출과 직렬화합니다.