Marshal.StringToBSTR(String) Метод

Определение

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

System.Runtime.InteropServices

Сборка:

System.Runtime.InteropServices.dll

Исходный код:

Marshal.cs

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

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

public static IntPtr StringToBSTR (string? s);

static member StringToBSTR : string -> nativeint

Public Shared Function StringToBSTR (s As String) As IntPtr

Параметры

s

String

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

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

IntPtr

nativeint

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

Исключения

OutOfMemoryException

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

ArgumentOutOfRangeException

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

Комментарии

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

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

• PtrToStringBSTR(IntPtr)
• FreeBSTR(IntPtr)