Compartilhar via


Marshal.StringToHGlobalUni(String) Método

Definição

Copia o conteúdo de um String gerenciado para uma memória não gerenciada.

public:
 static IntPtr StringToHGlobalUni(System::String ^ s);
[System.Security.SecurityCritical]
public static IntPtr StringToHGlobalUni (string s);
public static IntPtr StringToHGlobalUni (string? s);
public static IntPtr StringToHGlobalUni (string s);
[<System.Security.SecurityCritical>]
static member StringToHGlobalUni : string -> nativeint
static member StringToHGlobalUni : string -> nativeint
Public Shared Function StringToHGlobalUni (s As String) As IntPtr

Parâmetros

s
String

Uma cadeia de caracteres gerenciada a ser copiada.

Retornos

IntPtr

nativeint

O endereço, na memória não gerenciada, para o qual s foi copiado ou 0 se s for null.

Atributos

Exceções

Não foi possível para o método alocar memória suficiente de heap nativo.

O parâmetro s excede o tamanho máximo permitido pelo sistema operacional.

Comentários

StringToHGlobalUni é útil para marshaling personalizado ou para uso 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 FreeHGlobal. Esse método fornece a funcionalidade oposta de Marshal.PtrToStringUni.

Esse método copia caracteres nulos inseridos e inclui um caractere nulo de terminação.

Essa API reflete a definição do Windows de Unicode, que é uma codificação UTF-16 de 2 bytes. Em muitas plataformas não Windows, o wchar_t tipo de dados é de 4 bytes, não de 2 bytes. Consulte o compilador para confirmar se wchar_t pode ser usado ou char16_t deve ser usado.

Aplica-se a

Confira também