MONGOC_CLIENT...CREATE_DATAKEY(3) libmongoc MONGOC_CLIENT...CREATE_DATAKEY(3) SYNOPSIS bool mongoc_client_encryption_create_datakey ( mongoc_client_encryption_t *client_encryption, const char *kms_provider, const mongoc_client_encryption_datakey_opts_t *opts, bson_value_t *keyid, bson_error_t *error); Creates a new key document in the key vault collection and sets keyid to the UUID of the newly created key if keyid is not NULL. The new key can be used to configure automatic encryption (see mongoc_client_enable_auto_encryption() and mongoc_client_pool_enable_auto_encryption()) or for explicit encryption (see mongoc_client_encryption_encrypt()). The created key document is inserted into the key vault collection (identi- fied via mongoc_client_encryption_opts_set_keyvault_namespace()) with ma- jority write concern. keyid is always initialized (even on error). Caller must call - bson_value_destroy() on keyid to free. PARAMETERS * client_encryption: A mongoc_client_encryption_t. * kms_provider: A string identifying the Key Management Service (KMS) provider used to encrypt the datakey (e.g. "aws" or "local"). * opts: A mongoc_client_encryption_datakey_opts_t * keyid: Optional. An uninitialized bson_value_t set to the UUID (BSON bi- nary subtype 0x04) of the newly created key. Must be freed by - bson_value_destroy(). * error: Optional. A bson_error_t. RETURNS Returns true if successful. Returns false and sets error otherwise. SEE ALSO: mongoc_client_encryption_datakey_opts_t AUTHOR MongoDB, Inc COPYRIGHT 2009-present, MongoDB, Inc. 1.30.8 Aug 27, 2026 MONGOC_CLIENT...CREATE_DATAKEY(3)
SYNOPSIS | PARAMETERS | RETURNS | AUTHOR | COPYRIGHT
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mongoc_client_encryption_create_datakey&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>