Accept the originating transaction and commit any changes the hook made.
Concepts
Behaviour
End the execution of the hook with status: success.
- Record a return string and return code in transaction metadata.
- Commit all state changes.
- Submit all
emit()
transactions. - Allow originating transaction to continue.
Caution
If the originating transaction is stopped for some other reason then this accept becomes a rollback. See: Execution Order.
Definition
int64_t accept (
uint32_t read_ptr,
uint32_t read_len,
uint64_t error_code
);
Example
accept("Success", 7, 100);
Parameters
Name | Type | Description |
---|---|---|
read_ptr | uint32_t | Pointer to a return string to be stored in execution metadata. This is any string the hook-developer wishes to return with the acceptance. May be null. |
read_len | uint32_t | The length of the return string. At most 32. May be null. |
error_code | uint64_t | A return code specific to this hook to be stored in execution metadata. Similar to the return code of an application on a *nix system. By convention success is zero. |
Return Code
Type | Description |
---|---|
int64_t | Accept ends the hook, therefore no value is returned to the caller. By convention all Hook APIs return int64_t , but in this case nothing is returned. |