Marshal.StringToBSTR(String) Método

Referência

Definição

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Aloca um BSTR e copia o conteúdo de um String gerenciado para ele.

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

Parâmetros

s: String

A cadeia de caracteres gerenciada a ser copiada.

Retornos

IntPtr nativeint

Um ponteiro não gerenciado para o BSTR ou 0, se s for nulo.

Atributos: SecurityCriticalAttribute

Exceções

OutOfMemoryException

Memória insuficiente.

ArgumentOutOfRangeException

O tamanho de s está fora do intervalo.

Comentários

StringToBSTR é útil para marshaling personalizado ou ao misturar código gerenciado e não gerenciado. Como esse método aloca a memória não gerenciada necessária para uma cadeia de caracteres, sempre libere o BSTR quando terminar chamando Marshal.FreeBSTR. Esse método fornece a funcionalidade oposta de Marshal.PtrToStringBSTR.

Aplica-se a