Provided by: libmongoc-doc_1.23.1-1build1_all bug

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_canonical_extended_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" }

AUTHOR

       MongoDB, Inc

COPYRIGHT

       2017-present, MongoDB, Inc