add auth error handling

Author: rachel-mack

source/includes/authentication.cpp

@@ -45,4 +45,14 @@ auto client = mongocxx::client(uri);
 auto uri = mongocxx::uri("mongodb://<db_username>:<db_password>@<hostname>:<port>/?"
                          "authMechanism=PLAIN&tls=true");
 auto client = mongocxx::client(uri);
-// end-plain
+// end-plain
+
+// start-auth-err
+try {
+    auto uri = mongocxx::uri("mongodb://<>"
+                         "authMechanism=<>");
+    auto client = mongocxx::client(uri);
+} catch (const mongocxx::exception& e) {
+    std::cerr << "Error: " << e.code() << std::endl;
+}
+// end-auth-err

source/security/authentication.txt

@@ -273,6 +273,18 @@ URI to ``"MONGODB-AWS"``, as shown in the following example:
    to retrieve credentials only from an EC2 instance, ensure that the
    environment variables are not set.
 
+Error Handling
+--------------
+
+Authentication errors are thrown as ``mongocxx::exception``` errors. You can find
+the error code by using the ``code()`` method.
+
+.. literalinclude:: /includes/authentication.cpp
+   :language: cpp
+   :copyable: true
+   :start-after: // start-auth-err
+   :end-before: // end-auth-err
+
 API Documentation
 -----------------