pdcomm_gem_formatted_program_store_snapshot

함수

저장소 전체를 새로 소유하는 스냅샷으로 복사합니다.

PdcommStatus pdcomm_gem_formatted_program_store_snapshot(PdcommTcpEndpoint *endpoint, PdcommGemFormattedProgramStoreSnapshot **out_snapshot)

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

엔트리는 처음 추가된 순서대로 나타나며, 교체된 엔트리는 위치를 유지합니다.

매개변수

이름	설명
endpoint	정형 프로그램 조회 서비스가 구성된 장비 엔드포인트입니다.
out_snapshot	스냅샷을 받습니다. 먼저 NULL로 설정되므로, 유효한 엔드포인트에서는 실패하면 항상 NULL입니다.

반환값

성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 out_snapshot이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 엔드포인트가 장비가 아니거나 조회 서비스가 구성되지 않았으면 #PDCOMM_INVALID_STATE를 반환합니다. 준비된 TCP 이벤트(staged event)를 먼저 비워야 하면 #PDCOMM_BACKPRESSURE를 반환합니다. 사본을 할당할 수 없으면 #PDCOMM_ALLOCATION_FAILED를 반환합니다. 엔드포인트가 오염(poisoned) 상태이면 #PDCOMM_POISONED를 반환합니다.

참고

• 소유권: pdcomm_gem_formatted_program_store_snapshot_destroy()로 스냅샷을 해제합니다. 스냅샷은 이후 저장소가 바뀌거나 엔드포인트가 해제된 뒤에도 유효합니다.
• 스레드 안전성: endpoint에 대한 다른 모든 호출과 직렬화합니다.