WindowsRuntimeMarshal.StringToHString(String) Method

Reference

Definition

Namespace:: System.Runtime.InteropServices.WindowsRuntime

Assemblies:: mscorlib.dll, System.Runtime.InteropServices.WindowsRuntime.dll

Assembly:: System.Runtime.InteropServices.WindowsRuntime.dll

Assembly:: mscorlib.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Allocates a Windows RuntimeHSTRING and copies the specified managed string to it.

This API supports the product infrastructure and is not intended to be used directly from your code.

public:
 static IntPtr StringToHString(System::String ^ s);

[System.Security.SecurityCritical]
public static IntPtr StringToHString(string s);

public static IntPtr StringToHString(string s);

[<System.Security.SecurityCritical>]
static member StringToHString : string -> nativeint

static member StringToHString : string -> nativeint

Public Shared Function StringToHString (s As String) As IntPtr

Parameters

s: String

The managed string to copy.

Returns

IntPtr

An unmanaged pointer to the new HSTRING, or Zero if s is Empty.

Attributes: SecurityCriticalAttribute

Exceptions

PlatformNotSupportedException

The Windows Runtime is not supported on the current version of the operating system.

ArgumentNullException

s is null.

Remarks

Use the FreeHString method to release the HSTRING when you are done using it.

Applies to

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP	10.0

Споделяне чрез