Compartilhar via


Marshal.SecureStringToBSTR(SecureString) Método

Definição

Importante

Esta API não está em conformidade com CLS.

Aloca uma BSTR (cadeia de caracteres binária não gerenciada) e copia o conteúdo de um objeto gerenciado SecureString nele.

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

Parâmetros

s
SecureString

O objeto gerenciado a ser copiado.

Retornos

IntPtr

nativeint

O endereço, na memória não gerenciada, para o qual o s parâmetro foi copiado ou 0 se um objeto nulo foi fornecido.

Atributos

Exceções

O s parâmetro é null.

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

Comentários

O SecureStringToBSTR método é ú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 o ZeroFreeBSTR método.

Aplica-se a