MONGOC_OIDC_CALLBACK_FN_T(3)

📦
version 2.5.6 · 3 versions
, in epel 10

💅 MONGOC_OIDC_CALLBACK_FN_T(3) — a libmongoc moment

okay bestie, so this one is a manual page from libmongoc and it is literally just about one typedef. one. and honestly? she's serving function-pointer realness and we respect it. let's get into it ✨

✨ SYNOPSIS ✨

typedef mongoc_oidc_credential_t *(*mongoc_oidc_callback_fn_t) (mongoc_oidc_callback_params_t *params);

so this is the type of the function pointer that gets stored by mongoc_oidc_callback_t. that's the whole vibe. it's a callback signature, it points at a function, and that function is expected to hand back a credential. no cap 🫶

🎀 PARAMETERS 🎀

  • params — a mongoc_oidc_callback_params_t object, and she's an in/out situation: she carries the in/out parameters of a mongoc_oidc_callback_t. both directions, main character energy 💅

🔥 RETURNS 🔥

so your function gives back a mongoc_oidc_credential_t object — one you made with mongoc_oidc_credential_new() — or NULL, which is the signal for an error or a timeout. two very different moods, same NULL. 😭

the rules, and these are MUSTs so like, actually listen:

  • the function MUST return a mongoc_oidc_credential_t object to indicate success 💖
  • the function MUST return NULL to indicate an error
  • the function MUST call mongoc_oidc_callback_params_cancel_with_timeout() before returning NULL, if what actually happened was a timeout and not an error. like — tell the truth about which one it was, bestie 🙈
⚠️ heads up: the cancel_with_timeout out parameter gets ignored if the return value is not NULL. so if you're returning a real credential, that param is just standing there, unread. 💀

🦋 SEE ALSO 🦋

  • mongoc_oidc_callback_t
  • mongoc_oidc_callback_params_t
  • mongoc_oidc_credential_t

go read those next, iykyk 🌸

👑 AUTHOR 👑

MongoDB, Inc — icons only ⭐

2009-present, MongoDB, Inc. — periodt.

and that's the whole page, bestie! 🎀 this little beauty came to you from libmongoc version 2.5.6, dated Oct 09, 2026, and she's titled MONGOC_OIDC_CALLBACK_FN_T(3) — mwah, slay, go write that callback 🧚💜

📦 where this page comes from