Fix NullReferenceException in friendly overloads of COM methods with optional pointer parameters

[AArnott]

Optional parameters cannot be expressed with the ref modifier on COM methods in order to avoid a pointer type. Doing so disallows the possibility of passing in null. Even Unsafe.NullRef<T>() does not work because the .NET interop layer throws NullReferenceException when that's done.

Instead, we leave it as a pointer type.

An alternative to this may be to declare the parameter as an array that allows null or exactly 1 element. But the API wouldn't describe itself very well, and enforcement wouldn't exist, leading to possible runtime failures.

Fixes #1081

---

AI generated summary

This pull request includes a significant number of changes to various files in the codebase. The most important changes include adding a new enum to categorize different elements being generated in Generator.cs, modifying methods in Generator.Com.cs to generate appropriate type syntax based on the generating element, and adding a new test method in COMTests.cs to verify the declaration of COM methods.

Main interface changes:

• src/Microsoft.Windows.CsWin32/Generator.cs: Added an enum called GeneratingElement to categorize different elements being generated and modified the GetNamespaceForPossiblyNestedType method to include an additional parameter for the CreateParameterList method. [1] [2]
• src/Microsoft.Windows.CsWin32/Generator.Com.cs: Introduced changes to add new parameters to various methods for generating appropriate type syntax based on the generating element. [1] [2] [3] [4]
• test/Microsoft.Windows.CsWin32.Tests/COMTests.cs: Added a new test method to verify the declaration of COM methods that accept [Optional, In] parameters.

Other important changes:

• src/Microsoft.Windows.CsWin32/Generator.Constant.cs: Modified the CreateConstant method to include a new parameter forElement and modified the ToTypeSyntax method to include a new parameter GeneratingElement.Constant. [1] [2]
• src/Microsoft.Windows.CsWin32/Generator.Extern.cs: Added a new parameter forElement to the CreateParameterList method and the ToTypeSyntax method. [1] [2] [3]
• src/Microsoft.Windows.CsWin32/Generator.FriendlyOverloads.cs: Modified the CreateConstant method to add a new parameter forElement to the ToTypeSyntax method.
• src/Microsoft.Windows.CsWin32/Generator.Handle.cs: Added a new parameter to the ToTypeSyntax method and modified the code to pass a specific value based on the generating element. [1] [2] [3]

Please note that due to the large number of changes and limited space, only a subset of the changes are listed here.