Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
MONGOC_CLIENT_...YPTION_ENCRYPT(3)  libmongoc MONGOC_CLIENT_...YPTION_ENCRYPT(3)

SYNOPSIS
	bool
	mongoc_client_encryption_encrypt (
	   mongoc_client_encryption_t *client_encryption,
	   const bson_value_t *value,
	   mongoc_client_encryption_encrypt_opts_t *opts,
	   bson_value_t *ciphertext,
	   bson_error_t *error);

     Performs explicit encryption.

     ciphertext  is  always  initialized  (even  on failure). Caller must call -
     bson_value_destroy() to free.

     To insert or query with an "Indexed" or "Range" encrypted	payload,  use  a
     mongoc_client_t	configured   with   mongoc_auto_encryption_opts_t.   The
     mongoc_auto_encryption_opts_t may be configured to  bypass  query	analysis
     with      mongoc_auto_encryption_opts_set_bypass_query_analysis().      The
     mongoc_auto_encryption_opts_t must not be configured  to  bypass  automatic
     encryption with mongoc_auto_encryption_opts_set_bypass_auto_encryption().

     To 	 insert 	 with	       a	  Range 	 payload
     mongoc_client_encryption_encrypt_range_opts_t must be set in opts.

     To       query	   with        a	Range	     payload,	     use
     mongoc_client_encryption_encrypt_expression()

PARAMETERS
     * client_encryption: A mongoc_client_encryption_t

     * value: The value to encrypt.

     * opts: A mongoc_client_encryption_encrypt_opts_t.

     * ciphertext:  A  bson_value_t  for the resulting ciphertext (a BSON binary
       with subtype 6).

     * error: A bson_error_t set on failure.

RETURNS
     Returns true if successful. Returns false and sets error otherwise.

     SEE ALSO:
	mongoc_client_encryption_encrypt_opts_t

	mongoc_client_enable_auto_encryption()

	mongoc_client_decryption_decrypt()

	mongoc_client_encryption_encrypt_expression()

AUTHOR
     MongoDB, Inc

COPYRIGHT
     2009-present, MongoDB, Inc.

1.30.8				  Aug 27, 2026MONGOC_CLIENT_...YPTION_ENCRYPT(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mongoc_client_encryption_encrypt&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help