---
name: "mongoc_uri_set_mechanism_properties"
section: "3"
platform: "linux"
package: "libmongoc-doc"
version: "1.30.4-1+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mongoc_uri_set_mechanism_properties"
---

# mongoc\_uri\_set\_mechanism\_properties(3)

## SYNOPSIS

```
bool
mongoc_uri_set_mechanism_properties (mongoc_uri_t *uri,
                                     const bson_t *properties);
```

## PARAMETERS

- •

  **uri**: A *mongoc\_uri\_t*.

- •

  **properties**: A *bson\_t* .

## DESCRIPTION

Replaces all the options in URI's "authMechanismProperties" after the URI has been parsed from a string.

## RETURNS

Returns false if the option cannot be set, for example if **properties** is not valid BSON data.

## EXAMPLE

```
mongoc_uri_t *uri;
bson_t props = BSON_INITIALIZER;
uri = mongoc_uri_new (
   "mongodb://user%40DOMAIN.COM:password@localhost/?authMechanism=GSSAPI"
   "&authMechanismProperties=SERVICE_NAME:other,CANONICALIZE_HOST_NAME:true");
/* replace all options: replace service name "other" with "my_service", unset
 * "CANONICALIZE_HOST_NAME" and accept its default.
 */
BSON_APPEND_UTF8 (&props, "SERVICE_NAME", "my_service");
mongoc_uri_set_mechanism_properties (uri, &props);
bson_destroy (&props);
```

## AUTHOR

MongoDB, Inc

## COPYRIGHT

2009-present, MongoDB, Inc.