Marshal.StringToBSTR(String) Метод

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

System.Runtime.InteropServices.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Выделяет строку BSTR и копирует в нее содержимое управляемого объекта String.

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

Параметры

s

String

Копируемая управляемая строка.

Возвращаемое значение

IntPtr

nativeint

Неуправляемый указатель на строку BSTR или значение 0, если параметр s имеет значение null.

Атрибуты

SecurityCriticalAttribute

Исключения

OutOfMemoryException

Не хватает памяти.

ArgumentOutOfRangeException

Длина параметра s выходит за пределы диапазона.

Комментарии

StringToBSTR используется для пользовательского маршалинга или при смешивании управляемого и неуправляемого кода. Так как этот метод выделяет неуправляемую память, необходимую для строки, всегда освобождает BSTR время завершения путем вызова Marshal.FreeBSTR. Этот метод предоставляет противоположные функциональные возможности Marshal.PtrToStringBSTR.

См. также раздел

• PtrToStringBSTR(IntPtr)
• FreeBSTR(IntPtr)