mongoc_client_set_appname() — MongoDB C Driver 1.9.2

- MongoDB C Driver 1.9.2 »
- API Reference »
- mongoc_client_t

# mongoc_client_set_appname()

## Synopsis

    bool
    mongoc_client_set_appname (mongoc_client_t *client, const char *appname)

Sets the application name for this client. This string, along with other internal driver details, is sent to the server as part of the initial connection handshake (“isMaster”).

`appname` is copied, and doesn’t have to remain valid after the call to `mongoc_client_set_appname()`.

This function will log an error and return false in the following cases:

- `appname` is longer than `MONGOC_HANDSHAKE_APPNAME_MAX`
- `client` has already initiated a handshake
- `client` is from a mongoc_client_pool_t

## Parameters

- `client`: A mongoc_client_t.
- `appname`: The application name, of length at most `MONGOC_HANDSHAKE_APPNAME_MAX`.

## Returns

true if the appname is set successfully. Otherwise, false.

Created using Sphinx 1.6.5, based on Sphinx Readable Theme.