pdcomm::selectFormattedProgram

함수

장비의 정형 프로그램 저장소에서 프로그램을 선택합니다.

inline GemFormattedProgramSelectionToken selectFormattedProgram(GemEquipment &endpoint, const SecsItem &id)

선언 위치: #include <pdcomm_gem_formatted_program_selections.hpp>

선택은 로컬 상태만 기록하고 프로그램의 개별 사본을 만듭니다. 실제 물리적 실행은 시작하지 않습니다. 바뀌지 않은 같은 프로그램을 다시 선택하면 같은 토큰을 반환합니다. 이후 저장소 항목이 바뀌거나, 새 연결이 맺어지거나, 연결이 끊어지면 선택은 오래된(stale) 상태가 됩니다.

매개변수

이름	설명
endpoint	정형 프로그램 요청이 구성된(configureFormattedProgramQueries()) 장비 끝점(endpoint)입니다.
id	저장된 프로그램의 PPID입니다.

반환값

선택 토큰입니다.

참고

• 예외 pdcomm::Error: 호스트에서 호출하거나 저장소가 없거나 PPID가 저장되어 있지 않으면 PDCOMM_INVALID_STATE, 프로그램이 끝점의 메시지 한도보다 크면 PDCOMM_LIMIT_EXCEEDED, PPID가 잘못되면 PDCOMM_INVALID_ARGUMENT입니다.