Marshal.StringToHGlobalUni(String) Método
Definição
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.A managed string to be copied.
Retornos
O endereço, na memória não gerenciada, para o qual s foi copiado ou 0 se s for null.The address, in unmanaged memory, to where the s was copied, or 0 if s is null.
- Atributos
Exceções
Não foi possível para o método alocar memória suficiente de heap nativo.The method could not allocate enough native heap memory.
O parâmetro s excede o tamanho máximo permitido pelo sistema operacional.The s parameter exceeds the maximum length allowed by the operating system.
Comentários
StringToHGlobalUni é útil para marshaling personalizado ou para uso ao misturar código gerenciado e não gerenciado.StringToHGlobalUni is useful for custom marshaling or for use when mixing managed and unmanaged code. 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 .Because this method allocates the unmanaged memory required for a string, always free the memory by calling FreeHGlobal. Esse método fornece a funcionalidade oposta do Marshal.PtrToStringUni .This method provides the opposite functionality of Marshal.PtrToStringUni.
Esse método copia os caracteres nulos inseridos e inclui um caractere nulo de terminação.This method copies embedded null characters, and includes a terminating null character.