Marshal.StringToBSTR(String) Método

Definição

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

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

Exceções

Não há memória suficiente disponível.

O comprimento para 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

Confira também