Skip to content
Start free evaluation

pdcomm_gem_result_spool_error_at

Function

Reads one stream error from a received S2F44 (Host).

PdcommStatus pdcomm_gem_result_spool_error_at(const PdcommGemResult *result, size_t index, uint8_t *stream, uint8_t *acknowledgement, PdcommSecsItem **functions)

Declared in: #include <pdcomm_gem_spooling.h>

Parameters

NameDescription
result#PDCOMM_GEM_SPOOL_CONFIG_ACK response result.
indexZero-based error index.
streamReceives the rejected stream; set to 0 first. Must not be NULL.
acknowledgementReceives STRACK: 1 spooling not allowed for the stream, 2 unknown stream, 3 unknown function, 4 secondary function. Set to 0 first. Must not be NULL.
functionsReceives a new U1 item listing the offending functions. Set to NULL first. Must not be NULL.

Returns

#PDCOMM_OK on success; #PDCOMM_INVALID_ARGUMENT when an argument is NULL; #PDCOMM_INVALID_STATE when the result is not an S2F44 response; #PDCOMM_OUT_OF_RANGE when index is past the end; #PDCOMM_INVALID_DATA, #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, or #PDCOMM_INTERNAL_ERROR.

Notes

  • Ownership: release *functions with pdcomm_secs_destroy().