Marshal.StringToBSTR(String) Methode

Referenz

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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 Marshaling oder beim Mischen verwalteter und nicht verwalteter Code. Da diese Methode den für eine Zeichenfolge erforderlichen nicht verwalteten Arbeitsspeicher zuweist, lassen Sie den BSTR Zeitpunkt beim Aufrufen Marshal.FreeBSTRimmer frei. Diese Methode bietet die gegenteilige Funktionalität von Marshal.PtrToStringBSTR.

Gilt für