콘텐츠로 이동
무료 평가 시작

pdcomm_gem_result_command_parameter

함수

수신한 S2F41 요청의 CPNAME/CPVAL 쌍 하나를 복사합니다.

PdcommStatus pdcomm_gem_result_command_parameter(const PdcommGemResult *result, size_t index, PdcommSecsItem **out_name, PdcommSecsItem **out_value)

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

쌍은 중복을 포함해 전송 순서를 유지하며, 두 항목 모두 전송 형식(wire format)을 유지합니다.

매개변수

이름설명
result결과 유형이 #PDCOMM_GEM_COMMAND_RECEIVED인 요청 결과입니다.
index0부터 시작하는 매개변수 인덱스입니다.
out_name새 CPNAME 항목을 받습니다. 실패하면 항상 NULL입니다.
out_value새 CPVAL 항목을 받습니다. 실패하면 항상 NULL입니다.

반환값

성공하면 #PDCOMM_OK를 반환합니다. result, out_name 또는 out_value가 NULL이거나 두 출력이 겹치면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. result가 원격 명령 요청이 아니면 #PDCOMM_INVALID_STATE를 반환합니다. index가 매개변수 개수보다 작지 않으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 저장된 쌍의 형식이 잘못되었으면 #PDCOMM_INVALID_DATA를 반환합니다. 그 밖에 #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, #PDCOMM_INTERNAL_ERROR를 반환합니다.

참고

  • 소유권: pdcomm_secs_destroy()로 두 항목을 모두 해제합니다.