MONGOC_CLIENT_SESSION_APPEND(3) libmongoc MONGOC_CLIENT_SESSION_APPEND(3)

bool
mongoc_client_session_append (const mongoc_client_session_t *client_session,
                              bson_t *opts,
                              bson_error_t *error);


  • client_session: A pointer to a mongoc_client_session_t.
  • opts: A pointer to a bson_t.
  • error: An optional location for a bson_error_t or NULL.

This function appends a logical session id to command options. Use it to configure a session for any function that takes an options document, such as mongoc_client_write_command_with_opts().

It is an error to use a session for unacknowledged writes.

Returns true on success. If any arguments are invalid, returns false and fills out error.

See the example code for mongoc_client_session_t.

MongoDB, Inc

2017-present, MongoDB, Inc

March 31, 2024 1.26.0