SecureStringMarshal.SecureStringToCoTaskMemAnsi(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 objeto SecureString gerenciado para um bloco de memória alocado do alocador de tarefas COM não gerenciado.

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

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

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

Public Shared Function SecureStringToCoTaskMemAnsi (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 SecureStringToCoTaskMemAnsi 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 ZeroFreeCoTaskMemAnsi. Os caracteres da cadeia de caracteres são copiados como caracteres ANSI.