Implement Marshal.Get(Last)PInvokeErrorMessage() APIs.

[AaronRobinsonMSFT]

The behavior of this API is to return the same value as
new Win32Exception(error).Message, while avoiding the
instantiation of an exception.

Fixes #67872

/cc @danmoseley @dotnet/interop-contrib

[dotnet-issue-labeler]

Note regarding the new-api-needs-documentation label:

This serves as a reminder for when your PR is modifying a ref *.cs file and adding/modifying public APIs, to please make sure the API implementation in the src *.cs file is documented with triple slash comments, so the PR reviewers can sign off that change.

[ghost]

Tagging subscribers to this area: @dotnet/interop-contrib
See info in area-owners.md if you want to be subscribed.

Issue Details

---

The behavior of this API is to return the same value as
new Win32Exception(error).Message, while avoiding the
instantiation of an exception.

Fixes #67872

/cc @danmoseley @dotnet/interop-contrib

Author:	AaronRobinsonMSFT
Assignees:	-
Labels:	area-System.Runtime.InteropServices
Milestone:	7.0.0

[stephentoub]

There are other places using Interop.Kernel32.GetMessage. It'd be nice to have them changed (where possible) to just call Marshal.GetPInvokeErrorMessage, e.g.

runtime/src/libraries/Common/src/System/IO/Win32Marshal.cs

Line 62 in a103efd

string.IsNullOrEmpty(path) ? GetMessage(errorCode) : $"{GetMessage(errorCode)} : '{path}'",

runtime/src/libraries/System.Private.CoreLib/src/System/Environment.Variables.Windows.cs

Lines 51 to 54 in a103efd

	throw new OutOfMemoryException(Interop.Kernel32.GetMessage(errorCode));
	default:
	throw new ArgumentException(Interop.Kernel32.GetMessage(errorCode));

There are also places doing new Win32Exception().Message that should be changed to use this, e.g.

runtime/src/libraries/System.Security.Principal.Windows/src/System/Security/Principal/WindowsIdentity.cs

Line 134 in 4277bc5

throw new SecurityException(new Win32Exception().Message);

runtime/src/libraries/System.Security.Principal.Windows/src/System/Security/Principal/WindowsPrincipal.cs

Line 155 in 4277bc5

throw new SecurityException(new Win32Exception().Message);

runtime/src/libraries/System.ServiceProcess.ServiceController/src/System/ServiceProcess/ServiceBase.cs

Line 632 in a103efd

errorMessage = new Win32Exception().Message;

[danmoseley]

Nice improvement, thanks