From de277154511effa33f946a34ccc77deb074ce1c2 Mon Sep 17 00:00:00 2001
From: Hao Kung <HaoK@users.noreply.github.com>
Date: Tue, 14 Sep 2021 13:48:16 -0700
Subject: [PATCH] Clarify InvokeHandlersAfterFailure (#36501)

---
 .../Authorization/Core/src/AuthorizationHandlerContext.cs       | 2 +-
 src/Security/Authorization/Core/src/AuthorizationOptions.cs     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Security/Authorization/Core/src/AuthorizationHandlerContext.cs b/src/Security/Authorization/Core/src/AuthorizationHandlerContext.cs
index 6f3da4fcdae..97f9bff75c5 100644
--- a/src/Security/Authorization/Core/src/AuthorizationHandlerContext.cs
+++ b/src/Security/Authorization/Core/src/AuthorizationHandlerContext.cs
@@ -67,7 +67,7 @@ namespace Microsoft.AspNetCore.Authorization
             => (IEnumerable<AuthorizationFailureReason>?)_failedReasons ?? Array.Empty<AuthorizationFailureReason>();
 
         /// <summary>
-        /// Flag indicating whether the current authorization processing has failed.
+        /// Flag indicating whether the current authorization processing has failed due to Fail being called.
         /// </summary>
         public virtual bool HasFailed { get { return _failCalled; } }
 
diff --git a/src/Security/Authorization/Core/src/AuthorizationOptions.cs b/src/Security/Authorization/Core/src/AuthorizationOptions.cs
index 30f6b259a98..3d1f449bcae 100644
--- a/src/Security/Authorization/Core/src/AuthorizationOptions.cs
+++ b/src/Security/Authorization/Core/src/AuthorizationOptions.cs
@@ -14,7 +14,7 @@ namespace Microsoft.AspNetCore.Authorization
         private Dictionary<string, AuthorizationPolicy> PolicyMap { get; } = new Dictionary<string, AuthorizationPolicy>(StringComparer.OrdinalIgnoreCase);
 
         /// <summary>
-        /// Determines whether authentication handlers should be invoked after a failure.
+        /// Determines whether authentication handlers should be invoked after <see cref="AuthorizationHandlerContext.HasFailed"/>.
         /// Defaults to true.
         /// </summary>
         public bool InvokeHandlersAfterFailure { get; set; } = true;