dotnet / dotnet/docs

Misleading wording on how to specify class id when exposing class to COM

Open
#23,475 1 comment 0 reactions 0 assignees View on GitHub
dotnet-fundamentals/svc
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
15h 21m
Merged PRs (30d)
370

Description

It point 8 it says

> Add the [Guid("")] attribute to the class, with the class identifier GUID for the COM class you're implementing. For example, [Guid("9f35b6f5-2c05-4e7f-93aa-ee087f6e7ab6")]. As with the interface GUID, this GUID must be unique since it is the only identifier of this **interface** to COM.

First, it says "interface" near the end of the sentence. It should be "class" here. "interface" was clearly copied from point 5 and here it's misleading.

Second, this step-by-step explanation is so detailed that it's clearly for noobies. Noobies may not know that class id and interface id should better not be the same. It'd be better to add that it "must be unique, because [] and also not be the same as class id above"

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: e0842844-005f-5004-022d-fce7a82daff8
* Version Independent ID: 88ddeba8-3b31-95f4-26b2-4a12a7313b47
* Content: [Exposing .NET Core components to COM](https://docs.microsoft.com/en-us/dotnet/core/native-interop/expose-components-to-com)
* Content Source: [docs/core/native-interop/expose-components-to-com.md](https://github.com/dotnet/docs/blob/main/docs/core/native-interop/expose-components-to-com.md)
* Product: **dotnet-fundamentals**
* GitHub Login: @jkoritzinsky
* Microsoft Alias: **jekoritz**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.