TTTK_MESSAGE_FAIL(3)

💖 NAME 💖

okay so this is a library call manual page, and the main character is tttk_message_fail — literally the “fail a message” function. yes bestie, the name is giving exactly what it does 💅✨

---

✨ SYNOPSIS ✨

#include &<Tt/tttk.h>
Tt_status tttk_message_fail(
Tt_message msg,
Tt_status status,
const char *status_string,
int destroy);

---

🦋 DESCRIPTION 🦋

okay so tttk_message_fail does a little three-step slay: it sets the status and status string of the TT_REQUEST msg, then it fails msg, and then — if destroy is True — it destroys msg. periodt. 💖🔥

---

🌸 RETURN VALUE 🌸

upon successful completion, tttk_message_fail returns the status of the operation as one of these Tt_status values:

• TT_OK — the operation completed successfully. slay ✨
• TT_ERR_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it. 😭
• TT_ERR_NOTHANDLER — this application is not the handler for this message. not your message, not your problem 💅
• TT_ERR_POINTER — the pointer passed does not point to an object of the correct type for this operation. rude, but okay 🙈

---

🔥 SEE ALSO 🔥

go read these next, iykyk:

• Tt/tttk.h - Tttttk(5), tt_message_fail(3), tttk_message_abandon(3), tttk_message_reject(3).

---

xoxo, from the tttk_message_fail(library call) source/version — no date listed, so we’re calling it timeless 🎀💜🫶