mongoc_database_add_user() — MongoDB C Driver 1.6.3

- MongoDB C Driver 1.6.3 »
- API Reference »
- mongoc_database_t

# 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.

Created using Sphinx 1.5.3, based on Sphinx Readable Theme.