Método Marshal.SecureStringToBSTR (SecureString)

Artigo
04/23/2018

Dica

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Aloca um não gerenciado binary string (BSTR) e copia o conteúdo de um gerenciado SecureString objeto nele.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (em mscorlib.dll)

Sintaxe

[SecurityCriticalAttribute]
public static IntPtr SecureStringToBSTR(
    SecureString s
)

public:
[SecurityCriticalAttribute]
static IntPtr SecureStringToBSTR(
    SecureString^ s
)

[<SecurityCriticalAttribute>]
static member SecureStringToBSTR : 
        s:SecureString -> nativeint

<SecurityCriticalAttribute>
Public Shared Function SecureStringToBSTR (
    s As SecureString
) As IntPtr

Parâmetros

s
Type: System.Security.SecureString

O objeto gerenciado a se copiar.

Valor Retornado

Type: System.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.

Exceções

Exception	Condition
ArgumentNullException	O parâmetro s é null.
NotSupportedException	O computador atual não está executando o Windows 2000 Service Pack 3 ou posterior.
OutOfMemoryException	Não há memória suficiente disponível.

Comentários

O SecureStringToBSTR método é útil para empacotamento personalizado ou ao misturar gerenciado e código não gerenciado. Como esse método aloca a memória não gerenciada, necessária para uma cadeia de caracteres, sempre liberar o BSTR quando terminar, chamando o ZeroFreeBSTR método.

Observações para os Autores de Chamada:

Esse método é suportada apenas em computadores que executam o Windows 2000 Service Pack 3 ou posterior.

Segurança

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Informações de Versão

.NET Framework
Disponível desde 2.0

Confira Também

Classe Marshal
Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via