Marshal.SecureStringToBSTR(SecureString) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Importante
Esta API não está em conformidade com CLS.
Aloca uma BSTR (cadeia de caracteres binária não gerenciada) e copia o conteúdo de um objeto gerenciado SecureString nele.
public:
static IntPtr SecureStringToBSTR(System::Security::SecureString ^ s);
public static IntPtr SecureStringToBSTR(System.Security.SecureString s);
[System.CLSCompliant(false)]
public static IntPtr SecureStringToBSTR(System.Security.SecureString s);
[System.Security.SecurityCritical]
public static IntPtr SecureStringToBSTR(System.Security.SecureString s);
static member SecureStringToBSTR : System.Security.SecureString -> nativeint
[<System.CLSCompliant(false)>]
static member SecureStringToBSTR : System.Security.SecureString -> nativeint
[<System.Security.SecurityCritical>]
static member SecureStringToBSTR : System.Security.SecureString -> nativeint
Public Shared Function SecureStringToBSTR (s As SecureString) As IntPtr
Parâmetros
O objeto gerenciado a ser copiado.
Retornos
nativeint
O endereço, na memória não gerenciada, para o qual o s parâmetro foi copiado ou 0 se um objeto nulo foi fornecido.
- Atributos
Exceções
O s parâmetro é null.
Não há memória suficiente disponível.
Comentários
O SecureStringToBSTR 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 o BSTR quando terminar chamando o ZeroFreeBSTR método.