MONGOC_URI_GET_MECHANISM_PROPERTIES(3)

NAME
mongoc_uri_get_mechanism_properties - mongoc_uri_get_mechanism_properties()

SYNOPSIS

bool
mongoc_uri_get_mechanism_properties (const mongoc_uri_t *uri,
                                     bson_t *properties /* OUT */);

PARAMETERS

•   uri: A mongoc_uri_t.

•   properties: An uninitialized bson_t.

DESCRIPTION

Fetches the "authMechanismProperties" options set on this mongoc_uri_t. The out-parameter properties should be an uninitialized, stack-allocated bson_t. It is statically initialized with bson_init_static() to point to the internal data of uri, so its contents must not be modified and it becomes invalid after uri is destroyed.

RETURNS

If no "authMechanismProperties" have been set on uri, this functions returns false and properties remains uninitialized.

EXAMPLE

mongoc_uri_t *uri;
bson_t props;
uri = mongoc_uri_new (
   "mongodb://user%40DOMAIN.COM:password@localhost/?authMechanism=GSSAPI"
   "&authMechanismProperties=SERVICE_NAME:other,CANONICALIZE_HOST_NAME:true");
if (mongoc_uri_get_mechanism_properties (uri, &props)) {
   char *json = bson_as_json (&props, NULL);
   printf ("%s\n", json);
   bson_free (json);
} else {
   printf ("No authMechanismProperties.\n");
}

This code produces the output:

{ "SERVICE_NAME" : "other", "CANONICALIZE_HOST_NAME" : "true" }

SEE ALSO

GSSAPI (Kerberos) Authentication and mongoc_uri_set_mechanism_properties

AUTHOR
MongoDB, Inc

COPYRIGHT
2017, MongoDB, Inc