pdcomm_gem_result_formatted_program_id_get

Function

Copies the PPID of a verification report as a new SECS-II item.

PdcommStatus pdcomm_gem_result_formatted_program_id_get(const PdcommGemResult *result, PdcommSecsItem **out_item)

Declared in: #include <pdcomm_gem_formatted_programs.h>

Works for a received S7F27 result and for a verification negotiation result that carries a verification report (see pdcomm_gem_formatted_program_verification_negotiation.h).

Parameters

Name	Description
result	GEM result.
out_item	Receives a new ASCII or Binary item. Set to NULL once both pointers are non-NULL, so it is NULL after any later failure.

Returns

#PDCOMM_OK on success; #PDCOMM_INVALID_ARGUMENT when result or out_item is NULL; #PDCOMM_INVALID_STATE when the result carries no verification report (for example an S7F28 acknowledge result); #PDCOMM_ALLOCATION_FAILED or #PDCOMM_LIMIT_EXCEEDED when the item cannot be created; #PDCOMM_INTERNAL_ERROR when a panic was contained.

Notes

• Ownership: release the item with pdcomm_secs_destroy(). It stays valid after the result and the endpoint are destroyed.