Marshal.StringToBSTR(String) Methode

Referenz

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Weist einen BSTR zu und kopiert den Inhalt eines verwalteten String hinein.

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

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

public static IntPtr StringToBSTR (string? s);

public static IntPtr StringToBSTR (string s);

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

static member StringToBSTR : string -> nativeint

Public Shared Function StringToBSTR (s As String) As IntPtr

Parameter

s: String

Die zu kopierende verwaltete Zeichenfolge.

Gibt zurück

IntPtr

nativeint

Ein nicht verwalteter Zeiger auf das BSTR oder 0, wenn s NULL ist.

Attribute: SecurityCriticalAttribute

Ausnahmen

OutOfMemoryException

Es ist nicht genügend Arbeitsspeicher verfügbar.

ArgumentOutOfRangeException

Die Länge für s liegt außerhalb des gültigen Bereichs.

Hinweise

StringToBSTR ist nützlich für benutzerdefiniertes Marshalling oder beim Mischen von verwaltetem und nicht verwaltetem Code. Da diese Methode den nicht verwalteten Arbeitsspeicher zuordnet, der für eine Zeichenfolge erforderlich ist, geben Sie immer frei, wenn Sie BSTR fertig sind, indem Sie aufrufen Marshal.FreeBSTR. Diese Methode stellt die entgegengesetzte Funktionalität von bereit Marshal.PtrToStringBSTR.

Gilt für:

Share via