Marshal.StringToHGlobalUni-Methode: (String)

 

Veröffentlicht: Oktober 2016

Kopiert den Inhalt eines verwalteten String in den nicht verwalteten Speicher.

Namespace:   System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

Syntax

[SecurityCriticalAttribute]
public static IntPtr StringToHGlobalUni(
    string s
)

public:
[SecurityCriticalAttribute]
static IntPtr StringToHGlobalUni(
    String^ s
)

[<SecurityCriticalAttribute>]
static member StringToHGlobalUni : 
        s:string -> nativeint

<SecurityCriticalAttribute>
Public Shared Function StringToHGlobalUni (
    s As String
) As IntPtr

Parameter

• s
  Type: System.String

  Eine zu kopierende verwaltete Zeichenfolge.

Rückgabewert

Type: System.IntPtr

Die Adresse im nicht verwalteten Arbeitsspeicher, an die s kopiert wurde, oder 0, wenn s gleich null ist.

Ausnahmen

Exception	Condition
OutOfMemoryException	Die Methode konnte nicht genügend Speicher für systemeigenen Heap reservieren.
ArgumentOutOfRangeException	Die s Parameter überschreitet die maximale Länge vom Betriebssystem.

Hinweise

StringToHGlobalUni eignet sich für die benutzerdefinierten Marshalling oder beim Kombinieren von verwaltetem und nicht verwaltetem Code. Da diese Methode den nicht verwalteten Speicher für eine Zeichenfolge erforderlich belegt wird, müssen Sie den Speicher immer freigeben, durch Aufrufen von FreeHGlobal. Diese Methode stellt die Umkehrfunktionen der Marshal.PtrToStringUni.

Diese Methode kopiert eingebetteten Null-Zeichen und ein abschließendes Null-Zeichen enthält.

Sicherheit

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Versionsinformationen

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Windows Phone
Verfügbar seit 8.1

Siehe auch

PtrToStringUni
Marshal-Klasse
System.Runtime.InteropServices-Namespace

Zurück zum Anfang