Compartir a través de

Método Marshal.StringToBSTR (String)

  • Artículo

 

Publicado: octubre de 2016

Asigna un BSTR y copia el contenido de una clase administrada String en él.

Espacio de nombres:   System.Runtime.InteropServices
Ensamblado:  mscorlib (en mscorlib.dll)

Sintaxis

[SecurityCriticalAttribute]
public static IntPtr StringToBSTR(
    string s
)

public:
[SecurityCriticalAttribute]
static IntPtr StringToBSTR(
    String^ s
)

[<SecurityCriticalAttribute>]
static member StringToBSTR : 
        s:string -> nativeint

<SecurityCriticalAttribute>
Public Shared Function StringToBSTR (
    s As String
) As IntPtr

Parámetros

Valor devuelto

Type: System.IntPtr

Puntero no administrado a BSTR o 0 si s es null.

Excepciones

Exception Condition
OutOfMemoryException

No hay suficiente memoria disponible.
ArgumentOutOfRangeException

La longitud de s está fuera del intervalo.

Comentarios

StringToBSTR es útil para el cálculo de referencias personalizado o cuando se combina código administrado y no administrado. Dado que este método asigna la memoria no administrada necesaria para una cadena, libere siempre el BSTR cuando haya terminado mediante una llamada a Marshal.FreeBSTR. Este método proporciona la funcionalidad opuesta de Marshal.PtrToStringBSTR.

Seguridad

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Información de versión

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Windows Phone
Disponible desde 8.1

Ver también

PtrToStringBSTR
FreeBSTR
Clase Marshal
Espacio de nombres System.Runtime.InteropServices

Volver al principio