pdcomm_gem_program_delete
Function
Sends an S7F17 delete process program send (Host only).
PdcommStatus pdcomm_gem_program_delete(PdcommTcpEndpoint *endpoint, const PdcommSecsItem *const *ids, size_t count, PdcommTcpToken *out_token)A zero count sends an empty list, which asks the Equipment to delete every program. The S7F18 acknowledgement (ACKC7) arrives as a #PDCOMM_GEM_PROGRAM_ACK_RECEIVED result. Requirements and budgets are as for pdcomm_gem_program_grant().
Parameters
| Name | Description |
|---|---|
endpoint | Communicating GEM Host endpoint with a program store. |
ids | Array of count PPID items. May be NULL when count is 0; no element may be NULL. |
count | Number of PPIDs; bounded by max_request_ids and the remaining pending-ID and pending-byte budgets. |
out_token | Receives the request token; zero after every failure. Must not be NULL. |
Returns
As pdcomm_gem_program_grant(); #PDCOMM_INVALID_STATE also when the endpoint is not a GEM Host.