Compartilhar via


SecureStringMarshal.SecureStringToCoTaskMemAnsi(SecureString) Método

Definição

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

O parâmetro s é null.

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.

Aplica-se a