Marshal.SecureStringToBSTR(SecureString) Método

Definición

Importante

Esta API no es conforme a CLS.

Asigna una cadena binaria (BSTR) no administrada y copia en ella el contenido de un objeto SecureString administrado.Allocates an unmanaged binary string (BSTR) and copies the contents of a managed SecureString object into it.

public:
 static IntPtr SecureStringToBSTR(System::Security::SecureString ^ s);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public static IntPtr SecureStringToBSTR (System.Security.SecureString s);
static member SecureStringToBSTR : System.Security.SecureString -> nativeint
Public Shared Function SecureStringToBSTR (s As SecureString) As IntPtr

Parámetros

s
SecureString

Objeto administrado que se va a copiar.The managed object to copy.

Devoluciones

Dirección, en memoria no administrada, donde se copió el parámetro s o 0 si se suministró un objeto null.The address, in unmanaged memory, where the s parameter was copied to, or 0 if a null object was supplied.

Atributos

Excepciones

El parámetro s es null.The s parameter is null.

El equipo actual no está ejecutando Windows 2000 Service Pack 3 o una versión posterior.The current computer is not running Windows 2000 Service Pack 3 or later.

No hay suficiente memoria disponible.There is insufficient memory available.

Comentarios

El método SecureStringToBSTR es útil para el cálculo de referencias personalizado o al combinar código administrado y no administrado.The SecureStringToBSTR method is useful for custom marshaling or when mixing managed and unmanaged code. Dado que este método asigna la memoria no administrada necesaria para una cadena, libere siempre el BSTR cuando termine llamando al método ZeroFreeBSTR.Because this method allocates the unmanaged memory required for a string, always free the BSTR when finished by calling the ZeroFreeBSTR method.

Notas a los autores de las llamadas

Este método solo se admite en equipos que ejecutan Windows 2000 Service Pack 3 o posterior.This method is supported only on computers running Windows 2000 Service Pack 3 or later.

Seguridad

SecurityCriticalAttribute
Requiere plena confianza para el llamador inmediato.requires full trust for the immediate caller. Este miembro no puede ser utilizado por código transparente o de confianza parcial.This member cannot be used by partially trusted or transparent code.

Se aplica a