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.