Marshal.StringToHGlobalUni(String) Methode

Definition

Kopiert den Inhalt eines verwalteten String in den nicht verwalteten Speicher.Copies the contents of a managed String into unmanaged memory.

public:
 static IntPtr StringToHGlobalUni(System::String ^ s);
[System.Security.SecurityCritical]
public static IntPtr StringToHGlobalUni (string s);
static member StringToHGlobalUni : string -> nativeint
Public Shared Function StringToHGlobalUni (s As String) As IntPtr

Parameter

s
String

Eine zu kopierende verwaltete Zeichenfolge.A managed string to be copied.

Gibt zurück

Die Adresse im nicht verwalteten Arbeitsspeicher, an die s kopiert wurde, oder 0, wenn s gleich null ist.The address, in unmanaged memory, to where the s was copied, or 0 if s is null.

Attribute

Ausnahmen

Die Methode konnte nicht genügend Speicher für den systemeigenen Heap belegen.The method could not allocate enough native heap memory.

Der s-Parameter übersteigt die vom Betriebssystem zugelassene maximale Länge.The s parameter exceeds the maximum length allowed by the operating system.

Hinweise

StringToHGlobalUni ist nützlich für das benutzerdefinierte Marshalling oder die Verwendung beim Mischen von verwaltetem und nicht verwaltetem Code.StringToHGlobalUni is useful for custom marshaling or for use when mixing managed and unmanaged code. Da diese Methode den für eine Zeichenfolge erforderlichen nicht verwalteten Arbeitsspeicher freigibt, wird der Speicher durch Aufrufen von FreeHGlobalimmer freigegeben.Because this method allocates the unmanaged memory required for a string, always free the memory by calling FreeHGlobal. Diese Methode stellt die gegen übergesetzte Funktionalität Marshal.PtrToStringUnibereit.This method provides the opposite functionality of Marshal.PtrToStringUni.

Diese Methode kopiert eingebettete NULL-Zeichen und schließt ein abschließendes NULL-Zeichen ein.This method copies embedded null characters, and includes a terminating null character.

Sicherheit

SecurityCriticalAttribute
Erfordert volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer.requires full trust for the immediate caller. Dieser Member kann nicht von teilweise vertrauenswürdigem oder transparentem Code verwendet werden.This member cannot be used by partially trusted or transparent code.

Gilt für:

Siehe auch