pdcomm_gem_result_formatted_program_transfer_id_get

Function

Copies the PPID of a received S7F23 program as a new SECS-II item.

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

Declared in: #include <pdcomm_gem_formatted_program_transfers.h>

Parameters

Name	Description
result	Result whose outcome is #PDCOMM_GEM_FORMATTED_PROGRAM_TRANSFER_RECEIVED, or the same result after it was answered.
out_item	Receives a new ASCII or Binary item. Set to NULL once both pointers are non-NULL.

Returns

#PDCOMM_OK on success; #PDCOMM_INVALID_ARGUMENT when result or out_item is NULL; #PDCOMM_INVALID_STATE when the result carries no received program (for example an S7F24 result); #PDCOMM_ALLOCATION_FAILED 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.