MONGOC_AUTO_E...LT_CLIENT_POOL(3)

💅 MONGOC_AUTO_ENCRYPTION_OPTS_SET_KEYVAULT_CLIENT_POOL ✨

okay bestie so this is a page from libmongoc (we love her) and it's all about telling your auto-encryption setup which client pool to use when it goes key-shopping. no cap, it's giving "optional but important." 💖

---

SYNOPSIS

void
mongoc_auto_encryption_opts_set_keyvault_client_pool (
   mongoc_auto_encryption_opts_t *opts, mongoc_client_pool_t *pool);

DESCRIPTION

so like, this function sets an optional separate mongoc_client_pool_t that gets used during key lookup for automatic encryption and decryption. that's it, that's the whole vibe. 🎀

but listen — it only applies to automatic encryption on a mongoc_client_pool_t. and here's the important part: it is invalid to set this for automatic encryption on a single-threaded mongoc_client_t. literally do not do it, it's not that kind of party. 🙈

PARAMETERS

• opts — a mongoc_auto_encryption_opts_t. your options object, your main character. ✨
• pool — a mongoc_client_pool_t to use for key queries. bestie, listen closely: this client pool should not have automatic encryption enabled, because it will only execute find commands against the key vault collection to retrieve keys for automatic encryption and decryption. it's like a little key-fetching errand runner, nothing more. 🏃‍♀️💨

🚨 also this pool MUST outlive any mongoc_client_pool_t which has been enabled to use it through mongoc_client_pool_enable_auto_encryption(). like, the pool stays alive longer than its users, periodt. otherwise you're asking for chaos energy and we don't do that here. 💀

SEE ALSO

• mongoc_client_pool_enable_auto_encryption()
• mongoc_auto_encryption_opts_set_keyvault_client()
• In-Use Encryption

---

AUTHOR

MongoDB, Inc 👑

COPYRIGHT

2009-present, MongoDB, Inc. 🌸

---

k byeee, this has been libmongoc version 2.5.6, dated Oct 09, 2026 — go forth and pool responsibly 🫶💜