mongoc_client_encryption_opts_set_kms_credential_provider_callback

New in version 1.23.0.

Synopsis

void
mongoc_client_encryption_opts_set_kms_credential_provider_callback (
  mongoc_client_encryption_opts_t *opts,
  mongoc_kms_credentials_provider_callback_fn fn,
  void *userdata);

Set the user-provided callback to provide KMS credentials on-demand when they are needed.

Parameters

SEE ALSO:

mongoc_auto_encryption_opts_set_kms_credential_provider_callback()

Related:

type mongoc_kms_credentials_provider_callback_fn
typedef
bool (*mongoc_kms_credentials_provider_callback_fn) (void *userdata,
                                                     const bson_t *params,
                                                     bson_t *out,
                                                     bson_error_t *error);

The type of a callback function for providing KMS providers data on-demand.

Parameters
  • userdata - The same userdata pointer provided to the userdata parameter when the callback was set.
  • params - Parameters for the requested KMS credentials. Currently empty.
  • out - The output bson_t in which to write the new KMS providers. When passed to the callback, this already points to an empty BSON document which must be populated.
  • error - An output parameter for indicating any errors that might occur while generating the KMS credentials.
Return value

Must return true on success, false on failure.

Author

MongoDB, Inc

Info

Mar 06, 2024 1.26.1 libmongoc