MONGOC_OIDC_C...MS_GET_TIMEOUT(3)

💅 MONGOC_OIDC_CALLBACK_PARAMS_GET_TIMEOUT — the libmongoc glow-up 🎀

okay so bestie, you're in the libmongoc manual, and this page is all about one little function that tells your OIDC callback when it's time to panic (respectfully). it's giving "clock check but make it a pointer". let's get into it ✨

---

✨ SYNOPSIS ✨

const int64_t *
mongoc_oidc_callback_params_get_timeout (const mongoc_oidc_callback_params_t *params);

---

So like, the whole point of this icon: it returns a value you can compare against the System Clock to figure out when a timeout must occur. 🕰️

the way that this is an ABSOLUTE time point, not a duration — yes, that matters, do not come for me. it's a when, not a how long. 💀

Your callback can signal a timeout error using mongoc_oidc_callback_params_cancel_with_timeout(). here's the whole vibe in code:

mongoc_oidc_credential_t *
example_callback_fn (mongoc_oidc_callback_params_t *params) {
   const int64_t *timeout = mongoc_oidc_callback_params_get_timeout (params);

   // NULL means "infinite" timeout.
   if (timeout && bson_get_monotonic_time () > *timeout) {
      return mongoc_oidc_callback_params_cancel_with_timeout (params);
   }

   // ... your code here ...
}

and the key lore 🗝️: a NULL (unset) return value means "infinite" timeout. literally no deadline, main character energy, go off. 🌈

---

🫶 PARAMETERS 🫶

• params: a mongoc_oidc_callback_params_t. that's it, that's the whole input. 💖

---

🎀 RETURNS 🎀

A value comparable with System Clock, or NULL. ⭐ (and remember, NULL = infinite, iykyk)

---

🦋 LIFECYCLE 🦋

⚠️ okay this part is important, do NOT skip it: the pointed-to int64_t is only valid for the duration of the invocation of the OIDC callback function. so like, don't stash that pointer and take it home. it expires faster than a Snapchat streak. 😭

👑 SEE ALSO 👑

• mongoc_oidc_callback_params_t
• mongoc_oidc_callback_t
• mongoc_oidc_callback_params_cancel_with_timeout()

---

💜 AUTHOR 💜

MongoDB, Inc — icons only, no cap. 👑

🌸 COPYRIGHT 🌸

2009-present, MongoDB, Inc.

---

and that's the page, bestie!! 🍓 frosted with love by libmongoc version 2.5.6, dated Oct 09, 2026 — see you in the next manpage, mwah 💅✨🧚‍♀️