mongoc_database_add_user()

Synopsis

bool
mongoc_database_add_user (mongoc_database_t *database,
                          const char        *username,
                          const char        *password,
                          const bson_t      *roles,
                          const bson_t      *custom_data,
                          bson_error_t      *error);

Parameters

database

A mongoc_database_t.

username

The name of the user.

password

The cleartext password for the user.

roles

An optional bson_t for roles.

custom_data

A optional bson_t for extra data.

error

A location for a bson_error_t or NULL.

This function shall create a new user with access to database.

This function handles the difference between MongoDB 2.4 and 2.6.

Errors

Errors are returned through the error parameter and can include socket or other server side failures.

Returns

This function shall return true if the user was successfully added. In the event of an error, it returns false and error is set.