SecureStringMarshal.SecureStringToGlobalAllocAnsi(SecureString) Método

Definição

Namespace:

System.Security

Assembly:

System.Runtime.InteropServices.dll

Assembly:

System.Security.SecureString.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Copia o conteúdo de um SecureString gerenciado para a memória não gerenciada, convertendo em formato ANSI durante a cópia.

public:
 static IntPtr SecureStringToGlobalAllocAnsi(System::Security::SecureString ^ s);

public static IntPtr SecureStringToGlobalAllocAnsi (System.Security.SecureString s);

static member SecureStringToGlobalAllocAnsi : System.Security.SecureString -> nativeint

Public Shared Function SecureStringToGlobalAllocAnsi (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 SecureStringToGlobalAllocAnsi 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 a memória chamando o ZeroFreeGlobalAllocAnsi método.