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 copia os conteúdos de um objeto SecureString gerenciado para ela.

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 se copiar.

Retornos

IntPtr

nativeint

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

Atributos

Exceções

O parâmetro s é null.

Memória insuficiente.

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