Merge pull request MicrosoftDocs#4447 from MugBergerFries/patch-8

Updated C6308

Author: Stacyrch140

docs/code-quality/c6308.md

@@ -1,68 +1,68 @@
 ---
-title: C6308
+title: Warning C6308
 description: "Understand the causes of Microsoft C/C++ code analysis warning C6308, and learn how to fix them."
-ms.date: 10/23/2020
+ms.date: 09/28/2022
 ms.topic: reference
-f1_keywords: ["C6308"]
+f1_keywords: ["C6308", "REALLOCLEAK", "__WARNING_REALLOCLEAK"]
 helpviewer_keywords: ["C6308"]
 ms.assetid: 1162cd96-9037-4576-9858-0c8361a12559
 ---
-# C6308
+# Warning C6308
 
-> warning C6308: 'realloc' may return null pointer: assigning a null pointer to \<variable>, which is passed as an argument to 'realloc', will cause the original memory block to be leaked
+> 'realloc' may return null pointer: assigning a null pointer to '*parameter-name*', which is passed as an argument to 'realloc', will cause the original memory block to be leaked
 
-This warning indicates a memory leak that is the result of the incorrect use of a reallocation function. Heap reallocation functions do not free the passed buffer if reallocation is unsuccessful. To correct the defect, assign the result of the reallocation function to a temporary, and then replace the original pointer after successful reallocation.
+## Remarks
+
+Heap reallocation functions don't free the passed buffer if reallocation is unsuccessful, potentially resulting in a memory leak if not handled properly. To correct the issue, assign the result of the reallocation function to a temporary variable, and then replace the original pointer after successful reallocation.
+
+Code analysis name: REALLOCLEAK
 
 ## Example
 
-The following sample code generates this warning:
+The following sample code generates warning C6308. This issue stems from the assignment of the return value from `realloc` to `x`. If `realloc` fails and returns a null pointer, then the original memory pointed to by `x` won't be freed:
 
 ```cpp
 #include <malloc.h>
 #include <windows.h>
 
 void f( )
 {
-  char *x;
-  x = (char *) malloc(10);
-  if (x != NULL)
-  {
-    x = (char *) realloc(x, 512);
-    // code...
-    free(x);
-  }
+    char *x = (char *) malloc(10);
+    if (x != NULL)
+    {
+        x = (char *) realloc(x, 512);
+        // code...
+        free(x);
+    }
 }
 ```
 
-To correct this warning, use the following code:
+To resolve the issue, you can create a temporary variable to store the return value of `realloc`. This change allows you to free the previously allocated memory safely if `realloc` fails:
 
 ```cpp
 #include <malloc.h>
 #include <windows.h>
 
 void f()
 {
-  char *x, *tmp;
-
-  x = (char *) malloc(10);
-
-  if (x != NULL)
-  {
-    tmp = (char *) realloc(x,512);
-    if (tmp != NULL)
+    char *x = (char *) malloc(10);
+    if (x != NULL)
     {
-      x = tmp;
+        char *tmp = (char *) realloc(x,512);
+        if (tmp != NULL)
+        {
+            x = tmp;
+        }
+        // code...
+        free(x);
     }
-    // code...
-    free(x);
-  }
 }
 ```
 
-This warning might generate noise if there is a live alias to the buffer-to-be-reallocated at the time of the assignment of the result of the reallocation function.
+This warning might generate noise if there's a live alias to the buffer-to-be-reallocated at the time of the assignment of the result of the reallocation function.
 
-To avoid these kinds of problems altogether, use the mechanisms that are provided by the C++ Standard Template Library (STL). These include [shared_ptr](../standard-library/shared-ptr-class.md), [unique_ptr](../standard-library/unique-ptr-class.md), and [vector](../standard-library/vector.md). For more information, see [Smart Pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md).
+To avoid these kinds of issues altogether, you can use the mechanisms that are provided by the C++ Standard Template Library (STL). These include [`shared_ptr`](../standard-library/shared-ptr-class.md), [`unique_ptr`](../standard-library/unique-ptr-class.md), and [`vector`](../standard-library/vector.md). For more information, see [Smart pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md).
 
 ## See also
 
-[C6014](../code-quality/c6014.md)
+[Warning C6014](../code-quality/c6014.md)