Marshal.StringToBSTR(String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.InteropServices

Zestaw:: System.Runtime.InteropServices.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Źródło:: Marshal.cs

Źródło:: Marshal.cs

Źródło:: Marshal.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przydziela element BSTR i kopiuje do niego zawartość zarządzanego String obiektu.

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

Parametry

s: String

Zarządzany ciąg do skopiowania.

Zwraca

IntPtr

nativeint

Niezarządzany wskaźnik do BSTRwartości , lub 0, jeśli s ma wartość null.

Atrybuty: SecurityCriticalAttribute

Wyjątki

OutOfMemoryException

Za mało dostępnej pamięci.

ArgumentOutOfRangeException

Długość dla s jest poza zakresem.

Uwagi

StringToBSTR jest przydatne w przypadku niestandardowego marshalingu lub podczas mieszania zarządzanego i niezarządzanych kodu. Ponieważ ta metoda przydziela niezarządzaną pamięć wymaganą dla ciągu, zawsze zwolnij BSTR po zakończeniu przez wywołanie metody Marshal.FreeBSTR. Ta metoda zapewnia odwrotną funkcjonalność programu Marshal.PtrToStringBSTR.

Dotyczy