Merge pull request #13599 from ghogen/msbuild-3283

Add details for MSB3283

Author: Stacyrch140

docs/msbuild/errors/msb3283.md

@@ -1,7 +1,7 @@
 ---
 title: "MSB3283 diagnostic code"
 description: "Cannot find wrapper assembly for type library 'value'. Verify that (1) the COM component is registered correctly and (2) your target platform is the same as the bitness of the COM component. For example, if the COM component is 32-bit, your target platform must not be 64-bit."
-ms.date: 12/06/2024
+ms.date: 2/7/2025
 ms.topic: "error-reference"
 f1_keywords:
  - MSB3283
@@ -27,13 +27,26 @@ This article describes the MSB3283 error code.
 ## Message text
 
 ```output
-MSB3283: Cannot find wrapper assembly for type library 'value'. Verify that (1) the COM component is registered correctly and (2) your target platform is the same as the bitness of the COM component. For example, if the COM component is 32-bit, your target platform must not be 64-bit.
+MSB3283: Cannot find wrapper assembly for type library 'type library'. Verify that (1) the COM component is registered correctly and (2) your target platform is the same as the bitness of the COM component. For example, if the COM component is 32-bit, your target platform must not be 64-bit.
 ```
 
 <!-- :::editable-content name="postOutputDescription"::: -->
-<!--
-{StrBegin="MSB3283: "}
--->
+## Remarks
+
+This error occurs when MSBuild is attempting to reference a COM wrapper for the specified type library (`.tlb` file), but it couldn't be found. This could be because the wrapper couldn't be created.
+
+The problem could be that bitness is incorrect, as the message suggests, but it could be another issue.
+
+A type library (`.tlb` file) includes type definitions for Windows native COM components. A COM wrapper is a .NET assembly that allows the COM components to be accessed from managed code. See [Importing a type library as an assembly](/dotnet/framework/interop/importing-a-type-library-as-an-assembly).
+
+In MSBuild, a wrapper assembly is typically generated from the details specified in a [COMReference](../common-msbuild-project-items.md#comreference) for [COMFileReference](../common-msbuild-project-items.md#comfilereference) by the [ResolveCOMReference](../resolvecomreference-task.md) task.
+
+Check all the information provided in the `COMReference` or `COMFileReference`.
+
+`COMReference` uses the registry, so if you're using `COMReference`, you should verify that the COM component is correctly registered. See [Registering COM applications](/windows/win32/com/registering-com-applications).
+
+You can avoid registering the COM components on the build machine by using `COMFileReference`.
+
 <!-- :::editable-content-end::: -->
 <!-- :::ErrorDefinitionDescription-end::: -->