Marshal.StringToBSTR(String) Método
Definição
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.
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
nativeint
Um ponteiro não gerenciado para o BSTR
ou 0, se s
for nulo.
- Atributos
Exceções
Memória insuficiente.
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.