SecureStringMarshal.SecureStringToCoTaskMemUnicode(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 SecureStringToCoTaskMemUnicode(System::Security::SecureString ^ s);

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

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

Public Shared Function SecureStringToCoTaskMemUnicode (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 SecureStringToCoTaskMemUnicode 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 ZeroFreeCoTaskMemUnicode método. Os caracteres da cadeia de caracteres são copiados como caracteres Unicode.