Document warning C5267

Rageking8 · web-flow · commit bc6961442a7d · 2023-11-08T22:09:14.000+08:00
diff --git a/docs/cpp/explicitly-defaulted-and-deleted-functions.md b/docs/cpp/explicitly-defaulted-and-deleted-functions.md
@@ -36,7 +36,7 @@ This is convenient for simple types, but complex types often define one or more
 > - If a copy constructor or destructor is explicitly declared, then automatic generation of the copy-assignment operator is deprecated.
 > - If a copy-assignment operator or destructor is explicitly declared, then automatic generation of the copy constructor is deprecated.
 >
-> In both cases, Visual Studio continues to automatically generate the necessary functions implicitly, and does not emit a warning.
+> In both cases, Visual Studio continues to automatically generate the necessary functions implicitly, and does not emit a warning by default. Since Visual Studio 2022 version 17.7, [C5267](../error-messages/compiler-warnings/c5267.md) can be enabled to emit a warning.
 
 The consequences of these rules can also leak into object hierarchies. For example, if for any reason a base class fails to have a default constructor that's callable from a deriving class—that is, a **`public`** or **`protected`** constructor that takes no parameters—then a class that derives from it cannot automatically generate its own default constructor.
 
diff --git a/docs/error-messages/compiler-warnings/c5267.md b/docs/error-messages/compiler-warnings/c5267.md
@@ -0,0 +1,52 @@
+---
+title: "Compiler warning C5267"
+description: Compiler warning C5267 description and solution.
+ms.date: 11/08/2023
+f1_keywords: ["C5267"]
+helpviewer_keywords: ["C5267"]
+---
+# Compiler warning C5267
+
+> definition of implicit copy constructor/assignment operator for '*type*' is deprecated because it has a user-provided assignment operator/copy constructor
+
+## Remarks
+
+Since C++11, when only the copy constructor or copy assignment operator is explicitly defined, the implicit generation of the other is deprecated. However, to preserve backwards compatibility, the special functions are still implicitly generated.
+
+## Example
+
+The following sample code shows the warning being emitted when a deprecated implicitly generated special function is called, without it being explicitly defined:
+
+```cpp
+// C5267.cpp
+// compile using: /W4 /w45267
+struct CopyCtorOnly
+{
+    CopyCtorOnly() = default;
+    CopyCtorOnly(const CopyCtorOnly&) {}   // C5267
+};
+
+struct CopyAssignOpOnly
+{
+    CopyAssignOpOnly() = default;
+    CopyAssignOpOnly& operator=(const CopyAssignOpOnly&)   // C5267
+    {
+        return *this;
+    }
+};
+
+int main()
+{
+    CopyCtorOnly a1, a2;
+    a1 = a2;   // Calls deprecated copy assignment operator
+
+    CopyAssignOpOnly b1;
+    CopyAssignOpOnly b2 = b1;   // Calls deprecated copy constructor
+}
+```
+
+To resolve this issue explicitly define the missing copy constructor or copy assignment operator.
+
+## See also
+
+[Explicitly Defaulted and Deleted Functions](../../cpp/explicitly-defaulted-and-deleted-functions.md)
diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md b/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md
@@ -48,13 +48,22 @@ These versions of the compiler introduced new warnings:
 | Visual Studio 2022 version 17.3 | 19.33 |
 | Visual Studio 2022 version 17.4 | 19.34 |
 | Visual Studio 2022 version 17.5 | 19.35 |
+| Visual Studio 2022 version 17.7 | 19.37 |
 
 You can specify only the major number, the major and minor numbers, or the major, minor, and build numbers to the **`/Wv`** option. The compiler reports all warnings that match versions that begin with the specified number. It suppresses all warnings for versions greater than the specified number. For example, **`/Wv:17`** reports warnings introduced in or before any version of Visual Studio 2012, and suppresses warnings introduced by any compiler from Visual Studio 2013 (version 18) or later. To suppress warnings introduced in Visual Studio 2015 update 2 and later, you can use **`/Wv:19.00.23506`**. Use **`/Wv:19.11`** to report the warnings introduced in any version of Visual Studio before Visual Studio 2017 version 15.5, but suppress warnings introduced in Visual Studio 2017 version 15.5 and later.
 
 The following sections list the warnings introduced by each version of Visual C++ that you can suppress by using the **`/Wv`** compiler option. The **`/Wv`** option can't suppress warnings that aren't listed, which predate the specified versions of the compiler.
 
 ::: moniker range=">= msvc-170"
 
+## Warnings introduced in Visual Studio 2022 version 17.7 (compiler version 19.37)
+
+These warnings and all warnings in later versions are suppressed by using the compiler option **`/Wv:19.36`**.
+
+| Warning | Message |
+|--|--|
+| C5267 | definition of implicit copy constructor/assignment operator for '*type*' is deprecated because it has a user-provided assignment operator/copy constructor |
+
 ## Warnings introduced in Visual Studio 2022 version 17.5 (compiler version 19.35)
 
 These warnings and all warnings in later versions are suppressed by using the compiler option **`/Wv:19.34`**.
diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md
@@ -247,6 +247,7 @@ The articles in this section of the documentation explain a subset of the warnin
 | [Compiler warning (level 1, error, off) C5262](c5262.md) | implicit fall-through occurs here; are you missing a break statement? Use `[[fallthrough]]` when a `break` statement is intentionally omitted between cases |
 | Compiler warning (level 4, off) C5263 | calling '`std::move`' on a temporary object prevents copy elision |
 | Compiler warning (level 4, off) C5264 | '*variable-name*': 'const' variable is not used |
+| [Compiler warning C5267](c5267.md) | definition of implicit copy constructor/assignment operator for '*type*' is deprecated because it has a user-provided assignment operator/copy constructor |
 | Compiler warning (level 1, error) C5300 | '#pragma omp atomic': left operand of '*operator*' must match left hand side of assignment-expression |
 | [Compiler warning (level 1) C5301](c5301-c5302.md) | '#pragma omp for': '*loop-index*' increases while loop condition uses '*comparison*'; non-terminating loop? |
 | [Compiler warning (level 1) C5302](c5301-c5302.md) | '#pragma omp for': '*loop-index*' decreases while loop condition uses '*comparison*'; non-terminating loop? |
diff --git a/docs/error-messages/toc.yml b/docs/error-messages/toc.yml
@@ -4363,6 +4363,8 @@ items:
           href: compiler-warnings/c5248.md
         - name: Compiler warning (level 1, error, off) C5262
           href: compiler-warnings/c5262.md
+        - name: Compiler warning C5267
+          href: compiler-warnings/c5267.md
         - name: Compiler warning (level 1) C5301 and C5302
           href: compiler-warnings/c5301-c5302.md
 - name: Compiler warnings by compiler version
diff --git a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md
@@ -191,6 +191,7 @@ The following warnings are turned off by default in Visual Studio 2022 and later
 | [C5262](../error-messages/compiler-warnings/c5262.md) (level 1, error) | implicit fall-through occurs here; are you missing a `break` statement? Use `[[fallthrough]]` when a `break` statement is intentionally omitted between cases <sup>17.4</sup> |
 | C5263 (level 4) | calling '`std::move`' on a temporary object prevents copy elision <sup>17.4</sup> |
 | C5264 (level 4) | '*variable-name*': 'const' variable is not used <sup>17.4</sup> |
+| [C5267](../error-messages/compiler-warnings/c5267.md) | definition of implicit copy constructor/assignment operator for '*type*' is deprecated because it has a user-provided assignment operator/copy constructor <sup>17.7</sup> |
 
 <sup>14.1</sup> This warning is available starting in Visual Studio 2015 Update 1.\
 <sup>14.3</sup> This warning is available starting in Visual Studio 2015 Update 3.\
@@ -209,6 +210,9 @@ The following warnings are turned off by default in Visual Studio 2022 and later
 <sup>17.2</sup> This warning is available starting in Visual Studio 2022 version 17.2.\
 <sup>17.3</sup> This warning is available starting in Visual Studio 2022 version 17.3.\
 <sup>17.4</sup> This warning is available starting in Visual Studio 2022 version 17.4.\
+<sup>17.5</sup> This warning is available starting in Visual Studio 2022 version 17.5.\
+<sup>17.6</sup> This warning is available starting in Visual Studio 2022 version 17.6.\
+<sup>17.7</sup> This warning is available starting in Visual Studio 2022 version 17.7.\
 <sup>Perm</sup> This warning is off unless the [`/permissive-`](../build/reference/permissive-standards-conformance.md) compiler option is set.
 
 ## Warnings off by default in earlier versions

Original file line number	Diff line number	Diff line change
`@@ -36,7 +36,7 @@ This is convenient for simple types, but complex types often define one or more`
`36`	`36`	`> - If a copy constructor or destructor is explicitly declared, then automatic generation of the copy-assignment operator is deprecated.`
`37`	`37`	`> - If a copy-assignment operator or destructor is explicitly declared, then automatic generation of the copy constructor is deprecated.`
`38`	`38`	`>`
`39`		`-> In both cases, Visual Studio continues to automatically generate the necessary functions implicitly, and does not emit a warning.`
	`39`	`+> In both cases, Visual Studio continues to automatically generate the necessary functions implicitly, and does not emit a warning by default. Since Visual Studio 2022 version 17.7, [C5267](../error-messages/compiler-warnings/c5267.md) can be enabled to emit a warning.`
`40`	`40`
`41`	`41`	The consequences of these rules can also leak into object hierarchies. For example, if for any reason a base class fails to have a default constructor that's callable from a deriving class—that is, a `public` or `protected` constructor that takes no parameters—then a class that derives from it cannot automatically generate its own default constructor.
`42`	`42`