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);
[System.CLSCompliant(false)]
public static IntPtr SecureStringToBSTR(System.Security.SecureString s);
[System.Security.SecurityCritical]
public static IntPtr SecureStringToBSTR(System.Security.SecureString s);

Parâmetros

s
SecureString

O objeto gerenciado a se copiar.

Retornos

IntPtr

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

Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1