Marshal.SecureStringToBSTR(SecureString) Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origem:

Marshal.cs

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);

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.

Exceções

ArgumentNullException

O parâmetro s é null.

OutOfMemoryException

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 .