Update dependency Microsoft.Windows.CsWin32 to 0.3.298 by renovate[bot] · Pull Request #1269 · BeyondDimension/Common

renovate · 2026-06-12T19:46:06Z

This PR contains the following updates:

Package	Change	Age	Confidence
Microsoft.Windows.CsWin32 (source)	`0.3.162` → `0.3.298`

Release Notes

microsoft/CsWin32 (Microsoft.Windows.CsWin32)

`v0.3.296`

Changes:

Fixes:

#1703: CsWin32-generated COM structs trip CS3016 under [assembly: CLSCompliant(true)]

Enhancements:

#408: Fields in Anonymous nested structs should be exposed with property getters on the nesting struct
#1720: Generate generic overloads for IID_PPV_ARGS pattern on COM methods

Others:

#1531: Update nbgv and nerdbank.gitversioning updates to 3.9.50
#1727: Flatten anonymous bitfield sub-properties (#408 phase 2)
#1721: Flatten anonymous nested struct/union fields (#408)
#1715: fix: document inherited COM interface methods

See More

#1728: Serialize Linux test runs and capture crash dumps as a dedicated artifact
#1722: Limit test parallelism on Linux to avoid OOM kills
#1709: Update actions/checkout action to v5.0.1
#1723: Suppress CS3016 on internal COM wrappers without [CLSCompliant(false)] (#1703)

This list of changes was auto generated.

`v0.3.287`

Changes:

Fixes:

#1703: CsWin32-generated COM structs trip CS3016 under [assembly: CLSCompliant(true)]
#1704: IComIID is not emitted on net472 / netstandard2.0
#1716: Generated IStream.Read/Write forward to ISequentialStream and fail for IID_IStream COM objects
#1696: Broken code generated due to hardcoded "PInvoke" classname

Enhancements:

#1477: Allow specifying extension member target for static class

Others:

#1718: Add integration tests to PR gate and fix Roslyn 4 analyzer leg
#1701: Add extensionReceiver option for layered PInvoke composition (#1477)

See More

#1706: Mark internal COM struct wrappers [CLSCompliant(false)] when they carry CCW thunks
#1698: Auto-generated baselines by 1ES Pipeline Templates
#1705: Emit IComIID on downlevel TFMs (net472 / netstandard2.0)
#1555: Downgrade dependencies so the source analyzer works with .NET 8 SDK again
#1717: Fix #1716: emit friendly overloads for inherited COM methods on derived interfaces in source-generator mode
#1707: Bump .NET SDK to 10.0.108 (CG alert 1235255)
#1694: Add missing unchecked regions
#1697: Fix hardcoded PInvoke class name in ICCloseSafeHandle generation
#1690: Add validate gate job for single required status check
#1685: Add GitHub Actions workflow to run all tests in PR

This list of changes was auto generated.

`v0.3.275`

Changes:

#1678: Fix cross-winmd STATUS_SUCCESS lookup
#1672: Promote handle pointer to an out reference if handle cannot be trivially represented as a SafeHandle
#1668: Bump metadata version
#1621: Fix AppLocalAllowedLibraries handling in CsWin32RunAsBuildTask mode
#1623: Cleanup codecov sample comment
#1620: Reduce allocations

This list of changes was auto generated.

`v0.3.269`

Changes:

#1613: Use Marshal.InitHandle API to avoid memory leak when OOM happens
#1614: Update to latest win32metadata
#1603: Generate SafeHandle when freeing method accepts additional reserved parameters
#1597: Add more examples to the docs

This list of changes was auto generated.

`v0.3.264`

Changes:

#1593: Fix IDispatch property returns with built-in COM
#1591: Update README.md & add sample snippets
#1589: Add [Optional] on optional params

This list of changes was auto generated.

`v0.3.259`

Changes:

#1545: Generate struct wrapper around function pointer to make a native delegate typedef
#1578: Update win32metadata to latest (68.0.4-preview)

This list of changes was auto generated.

`v0.3.257`

Changes:

#1575: Fix bug when multiple Span-params share a CountParamIndex and one param is null
#1567: Fix mis-handling of parameters that are arrays of HANDLE
#1565: Switch CsWin32RunAsBuildTask to EmitSingleFile by default (for VS incremental scenario)
#1562: Move to .NET 10 SDK, add test coverage for net10 TFM

This list of changes was auto generated.

`v0.3.253`

Changes:

#1557: Improve intellisense experience with CsWin32RunAsBuildTask mode

This list of changes was auto generated.

`v0.3.252`

Changes:

#1550: Support $(ProjectName).NativeMethods.txt pattern for single-file-app projects
#1555: Downgrade dependencies so the source analyzer works with .NET 8 SDK again

This list of changes was auto generated.

`v0.3.250`

Changes:

#1554: Translate VARIANT to ComVariant when using COM source generators
#1548: Add common Win32 message parameter extraction macros

This list of changes was auto generated.

`v0.3.248`

Changes:

#1544: Improve optional out interface arguments (e.g. IWbemServices.GetObject) and other minor tweaks
#1547: Add test for cross-winmd IInspectable derivation and fix a tiny bug
#1541: Don't emit friendly overload of Span param for flexible array structs
#1536: Handle struct returns for COM interface methods across all marshalling modes
#1534: Preserve pointer return types
#1533: Fix out ** pointer parameters

This list of changes was auto generated.

`v0.3.242`

Changes:

#1524: Add an option to FriendlyOverloads to request previous pointer overloads
#1526: Generate real IDispatch when requested
#1522: [Retained] parameters need to project as pointer
#1521: Add implicit IntPtr casts to void* typedefs

This list of changes was auto generated.

`v0.3.238`

Changes:

#1520: Don't make void* params Span in friendly methods
#1517: CsWin32Generator should allow newer language versions

This list of changes was auto generated.

`v0.3.236`

NOTE: This changes the signature of methods with optional parameters. This change is also documented at https://microsoft.github.io/CsWin32/docs/getting-started.html:

Optional out/ref parameters

Some parameters in win32 are [optional, out] or [optional, in, out]. C# does not have an idiomatic way to represent this concept, so for any method that has such parameters, CsWin32 will generate two versions: one with all ref or out parameters included, and one with all such parameters omitted. For example:

// Omitting the optional parameter:
IsTextUnicode(buffer);

// Passing ref for optional parameter:
IS_TEXT_UNICODE_RESULT result = default;
IsTextUnicode(buffer, ref result);

Working with Span-typed and MemorySize-d parameters

In the Win32 APIs there are many functions where one parameter is a buffer (void* or byte*) and another parameter is the size of that buffer. When generating for a target framework that supports Spans, there will be overloads of these functions that take a Span<byte> which represents both of these parameters, since a Span refers to a chunk of memory and a length. For example, an API like IsTextUnicode has a void* parameter whose length is described by the iSize parameter in the native signature. The CsWin32 projection of this method will be:

BOOL IsTextUnicode(ReadOnlySpan<byte> lpv, ref IS_TEXT_UNICODE_RESULT lpiResult)

Instead of passing the buffer and length separately, in this projection you pass just one parameter. Span is a flexible type with many things that can be converted to it safely. You will also see Span parameters for things that may look like a struct but are variable sized. For example, InitializeAcl looks like it returns an ACL struct but the parameter is annotated with a [MemorySize] attribute in the metadata, indicating it is variable-sized based on another parameter. Thus, the cswin32 projection of this method will project this parameter as a Span<byte> since the size of the parameter is variable:

// The cswin32 signature:
static BOOL InitializeAcl(Span<byte> pAcl, ACE_REVISION dwAclRevision) { ... }

And you would call this by creating a buffer to receive the ACL. Then, after the call you can reinterpret the buffer as an ACL:

// Make a buffer
Span<byte> buffer = new byte[CalculateAclSize(...)];
InitializeAcl(buffer, ACE_REVISION.ACL_REVISION);

// The beginning of the buffer is an ACL, so cast it to a ref:
ref ACL acl = ref MemoryMarshal.AsRef<ACL>(buffer);

// Or treat it as a Span:
Span<ACL> aclSpan = MemoryMarshal.Cast<byte, ACL>(buffer);

CsWin32 will also generate a struct-typed parameter for convenience but this overload will pass sizeof(T) for the length parameter to the underlying Win32 API, so this only makes sense in some overloads such as SHGetFileInfo where the parameter has an annotation indicating it's variable-sized, but the size is only ever sizeof(SHFILEINFOW):

// Span<byte> overload:
static nuint SHGetFileInfo(string pszPath, FILE_FLAGS_AND_ATTRIBUTES dwFileAttributes, Span<byte> psfi, SHGFI_FLAGS uFlags)
// ref SHGETFILEINFOW overload:
static nuint SHGetFileInfo(string pszPath, FILE_FLAGS_AND_ATTRIBUTES dwFileAttributes, ref SHFILEINFOW psfi, SHGFI_FLAGS uFlags)

Changes:

#1511: Improve projection of MemorySize-d and optional ref/out parameters

`v0.3.235`

What's Changed

Handle CoCreateable classes in ComSourceGenerators mode by @jevansaks in #1502
Simplify decimal conversions by @jevansaks in #1512
Prevent SafeHandle from being re-generated in downstream assembly by @jevansaks in #1514
Fix ArithmeticOverflow in HANDLE types and other helpers when CheckForOverflowUnderflow is enabled by @jevansaks in #1513

Full Changelog: microsoft/CsWin32@v0.3.228...v0.3.235

`v0.3.228`

What's Changed

BuildTask mode should not generate types from InternalsVisibleTo referenced assemblies by @jevansaks in #1492
CsWin32 build task fixes for NET8/CSharp12 by @jevansaks in #1498
Fix platform case sensitivity issue with CsWin32Generator tool by @jevansaks in #1499
Update documentation for CsWin32RunAsBuildTask mode by @jevansaks in #1497
ArrayPool can be larger than requested resulting in freeing uninitialized GCHandles by @jlaanstra in #1405
Fix analyzer test break in devdiv AzDO account by @AArnott in #1504

New Contributors

@jlaanstra made their first contribution in #1405

Full Changelog: microsoft/CsWin32@v0.3.217...v0.3.228

https://www.nuget.org/packages/Microsoft.Windows.CsWin32/0.3.228

`v0.3.217`

What's Changed

Add cswin32 mode to generate [GeneratedComInterface] and [LibraryImport] code by @jevansaks in #1474
Handle UnauthorizedAccessException in new ComTests by @jevansaks in #1486
Project byte* parameters as Span by @jevansaks in #1488
Fix nuspec to refer to only signed files and drop apphost.exe from the nuget by @jevansaks in #1489

Full Changelog: microsoft/CsWin32@v0.3.213...v0.3.217

`v0.3.213`

What's Changed

Retarget to roslyn for VS 2022 Update 14 by @AArnott in #1466
.NET targeting projects should reference Microsoft.Windows.SDK.NET.Ref instead by @AArnott in #1471
Update win32metadata version to 65.0.8-preview by @jevansaks in #1469
Update dependency Microsoft.Build.NoTargets to 3.7.134 by @renovate[bot] in #1461

Full Changelog: microsoft/CsWin32@v0.3.205...v0.3.213

`v0.3.205`

What's Changed

Add msbuild item to opt 3rd party libraries into app-local deployments by @AArnott in #1381
Fix NRE thrown from friendly overloads with optional pointer parameters by @AArnott in #1385
Update getting-started.md by @LWChris in #1388
Remove test workaround by @DoctorKrolic in #1447
Add custom DebuggerDisplay for HRESULT by @misaz in #1445
Update documentation links from docs.microsoft.com to learn.microsoft.com by @xtqqczze in #1454
Merge latest Library.Template by @AArnott in #1458
Support for derived IInspectable COM interfaces in custom winmds by @jevansaks in #1459

New Contributors

@LWChris made their first contribution in #1388
@DoctorKrolic made their first contribution in #1447
@misaz made their first contribution in #1445
@xtqqczze made their first contribution in #1454

Full Changelog: microsoft/CsWin32@v0.3.183...v0.3.205

`v0.3.183`

Fixes

Generate WinRTCustomMarshaler when referenced from extern methods by @AArnott in #1335
Fix build break when friendly methods are turned off and IUnknown is generated by @AArnott in #1337

Enhancements

Use C# 13 overload resolution attribute to improve friendly overloads by @AArnott in #1336
Improve [Out] PWSTR parameters in friendly overloads by @AArnott in #1341
Friendly overloads replace PCWSTR* parameters with ReadOnlySpan<string> by @AArnott in #1346
Implement LOWORD and HIWORD Macros for Extracting Low-Order and High-Order Words from a 32-Bit Value by @vitkuz573 in #1300

New Contributors

@vitkuz573 made their first contribution in #1300

Full Changelog: microsoft/CsWin32@v0.3.162...v0.3.183

Configuration

📅 Schedule: (in timezone Asia/Shanghai)

Branch creation
- "before 1am,before 5am,before 9am"
Automerge
- At any time (no schedule defined)

🚦 Automerge: Enabled.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

renovate Bot added the 🤖 Automatic label Jun 12, 2026

renovate Bot force-pushed the renovate/microsoft.windows.cswin32-0.x branch from 98e85c1 to f5a0df5 Compare June 15, 2026 02:54

renovate Bot changed the title ~~Update dependency Microsoft.Windows.CsWin32 to 0.3.287~~ Update dependency Microsoft.Windows.CsWin32 to 0.3.296 Jun 15, 2026

Update dependency Microsoft.Windows.CsWin32 to 0.3.298

1ac096a

renovate Bot force-pushed the renovate/microsoft.windows.cswin32-0.x branch from f5a0df5 to 1ac096a Compare June 17, 2026 23:59

renovate Bot changed the title ~~Update dependency Microsoft.Windows.CsWin32 to 0.3.296~~ Update dependency Microsoft.Windows.CsWin32 to 0.3.298 Jun 17, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update dependency Microsoft.Windows.CsWin32 to 0.3.298#1269

Update dependency Microsoft.Windows.CsWin32 to 0.3.298#1269
renovate[bot] wants to merge 1 commit into
dev8from
renovate/microsoft.windows.cswin32-0.x

renovate Bot commented Jun 12, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

0 participants

Conversation

renovate Bot commented Jun 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release Notes

Changes:

Fixes:

Enhancements:

Others:

Changes:

Fixes:

Enhancements:

Others:

Changes:

Changes:

Changes:

Changes:

Changes:

Changes:

Changes:

Changes:

Changes:

Changes:

Changes:

Optional out/ref parameters

Working with Span-typed and MemorySize-d parameters

Changes:

What's Changed

What's Changed

New Contributors

What's Changed

What's Changed

What's Changed

New Contributors

Fixes

Enhancements

New Contributors

Configuration

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

0 participants

renovate Bot commented Jun 12, 2026 •

edited

Loading