trq_set_hard_flag()

`trq_set_hard_flag()`#

trq_set_hard_flag() marks a message with a hard flag, allowing it to be recovered in the next queue open if the flag is used in trq_load().

C

Prototype

int trq_set_hard_flag(
    q_msg   msg,
    uint32_t hard_mark,
    BOOL    set
);

Parameters

Key	Type	Description
`msg`	`q_msg`	The message to be marked.
`hard_mark`	`uint32_t`	The hard flag to set on the message.
`set`	`BOOL`	If `TRUE`, the flag is set; if `FALSE`, the flag is cleared.

Return Value

Returns 0 on success, or a negative value on failure.

Notes

A message must be flagged after being appended to the queue if it needs to be recovered in the next queue open using trq_load().

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python