Add documentation

Author: rahuldutta90

Microsoft.WindowsAzure.Storage/includes/was/core.h

@@ -1203,6 +1203,7 @@ namespace azure { namespace storage {
         /// <param name="last_request_result">The last request result.</param>
         /// <param name="next_location">The next location to retry.</param>
         /// <param name="current_location_mode">The current location mode.</param>
+        /// <param name="ex_ptr">Exception Ptr of any exception other than storage_exception</param>
         retry_context(int current_retry_count, request_result last_request_result, storage_location next_location, location_mode current_location_mode, const std::exception_ptr& ex_ptr = nullptr)
             : m_current_retry_count(current_retry_count), m_last_request_result(std::move(last_request_result)), m_next_location(next_location), m_current_location_mode(current_location_mode), m_unhandled_exception(ex_ptr)
         {
@@ -1249,9 +1250,10 @@ namespace azure { namespace storage {
         }
 
         /// <summary>
-        /// Gets the results of the last request.
+        /// Gets the exception_ptr of any unhandled exception during the request.
+        /// Example: WinHttp exceptions for timeout (12002)
         /// </summary>
-        /// <returns>An <see cref="azure::storage::request_result" /> object that represents the results of the last request.</returns>
+        /// <returns>An <see cref="std::exception_ptr" /> object that represents the results of the last request.</returns>
         const request_result& last_request_result() const
         {
             return m_last_request_result;
@@ -1275,6 +1277,10 @@ namespace azure { namespace storage {
             return m_current_location_mode;
         }
 
+        /// <summary>
+        /// Gets the location mode for subsequent retries.
+        /// </summary>
+        /// <returns>The <see cref="azure::storage::location_mode" /> for subsequent retries.</returns>
         const std::exception_ptr& unhandled_exception() const {
             return m_unhandled_exception;
         }