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 copia os conteúdos de um objeto SecureString gerenciado para ela.
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 se copiar.
Retornos
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.
- Atributos
Exceções
O parâmetro s
é null
.
Memória insuficiente.
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 .