[PATCH v3 06/18] gweb: Add documentation to 'call_result_func'.
Grant Erickson <[email protected]> Thu, 20 Mar 2025 16:38:57 -0700
| Newsgroups | dev.linux.lists.connman |
|---|---|
| Message-ID | <6c5d314bc2e5e20f507cb9caea5dc00f57fc06ee.1742513884.git.gerickson@nuovations.com> |
Add documentation to the 'call_result_func' function.
---
gweb/gweb.c | 24 ++++++++++++++++++++++++
1 file changed, 24 insertions(+)
diff --git a/gweb/gweb.c b/gweb/gweb.c
index ba3b62165f5e..e4dad4f95e42 100644
--- a/gweb/gweb.c
+++ b/gweb/gweb.c
@@ -165,6 +165,30 @@ static void _debug(GWeb *web, const char *file, const char *caller,
*/
G_DEFINE_QUARK(g-web-error-quark, g_web_error)
+/**
+ * @brief
+ * Invoke the closure callback associated with the web session
+ * request.
+ *
+ * This closes the specified web session request by invoking the @a
+ * result_func originally assigned in #do_request when the session
+ * was first initiated.
+ *
+ * @param[in] session
+ * A pointer to the mutable web session request for which to invoke
+ * the closure callback.
+ *
+ * @param[in] status
+ * HTTP status code on success to set in the @a session result
+ * structure. Note that #GWEB_HTTP_STATUS_CODE_UNKNOWN acts as a
+ * null value such that the status is only set if the value is
+ * not #GWEB_HTTP_STATUS_CODE_UNKNOWN.
+ *
+ * @sa do_request
+ *
+ * @private
+ *
+ */
static inline void call_result_func(struct web_session *session, guint16 status)
{
--
2.45.0