Marshal.StringToBSTR(String) Método

Definição

Aloca um BSTR e copia o conteúdo de um String gerenciado para ele.Allocates a BSTR and copies the contents of a managed String into it.

public:
 static IntPtr StringToBSTR(System::String ^ s);
[System.Security.SecurityCritical]
public static IntPtr StringToBSTR (string s);
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.The managed string to be copied.

Retornos

Um ponteiro não gerenciado para o BSTR ou 0, se s for nulo.An unmanaged pointer to the BSTR, or 0 if s is null.

Atributos

Exceções

Memória insuficiente.There is insufficient memory available.

O tamanho de s está fora do intervalo.The length for s is out of range.

Comentários

StringToBSTR é útil para marshaling personalizado ou ao misturar código gerenciado e não gerenciado.StringToBSTR is useful for custom marshaling or when mixing managed and unmanaged code. 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.Because this method allocates the unmanaged memory required for a string, always free the BSTR when finished by calling Marshal.FreeBSTR. Esse método fornece a funcionalidade oposta de Marshal.PtrToStringBSTR.This method provides the opposite functionality of Marshal.PtrToStringBSTR.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Aplica-se a

Veja também