pdcomm_gem_result_constant_change
Function
Copies one ECID/ECV pair of a received S2F15 and the value at receipt.
PdcommStatus pdcomm_gem_result_constant_change(const PdcommGemResult *result, size_t index, PdcommSecsItem **out_id, PdcommSecsItem **out_value, PdcommSecsItem **out_original)Request results only. The proposed ID and value keep their wire format and order. *out_original receives the constant's current value when the S2F15 was received, or stays NULL for an unknown ID.
Parameters
| Name | Description |
|---|---|
result | Result with outcome #PDCOMM_GEM_CONSTANT_CHANGES_RECEIVED. |
index | Zero-based pair position. |
out_id | Receives the proposed ID; set to NULL first. |
out_value | Receives the proposed value; set to NULL first. |
out_original | Receives the value at receipt or NULL; set to NULL first. |
Returns
#PDCOMM_OK on success; #PDCOMM_INVALID_ARGUMENT when a pointer is NULL or the outputs overlap; #PDCOMM_INVALID_STATE when result is not a received S2F15; #PDCOMM_OUT_OF_RANGE when index is not less than the pair count; #PDCOMM_INVALID_DATA, #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, or #PDCOMM_INTERNAL_ERROR. Every output is NULL after a failure.
Notes
- Ownership: release every non-NULL item with pdcomm_secs_destroy().