pdcomm_gem_result_enhanced_command_acknowledgements

Function

Copies the outer acknowledgement List of an enhanced command result.

PdcommStatus pdcomm_gem_result_enhanced_command_acknowledgements(const PdcommGemResult *result, PdcommSecsItem **out_acknowledgements)

Declared in: #include <pdcomm_gem_enhanced_commands.h>

For an accepted request the List is empty; for a rejected request it holds the frozen validation entries (names in normalized numeric form); for a Host reply it holds the received wire items exactly. The List is independent of the result.

Parameters

Name	Description
result	Result with outcome #PDCOMM_GEM_ENHANCED_COMMAND_RECEIVED or #PDCOMM_GEM_ENHANCED_COMMAND_ACK.
out_acknowledgements	Receives a new List item; NULL after every failure.

Returns

#PDCOMM_OK on success; #PDCOMM_INVALID_ARGUMENT when result or out_acknowledgements is NULL; #PDCOMM_INVALID_STATE when result is not an enhanced command result; #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, or #PDCOMM_INTERNAL_ERROR.

Notes

• Ownership: release *out_acknowledgements with pdcomm_secs_destroy().