Marshal.StringToHGlobalUni(String) Método

Definição

Copia o conteúdo de um String gerenciado para uma memória não gerenciada.Copies the contents of a managed String into unmanaged memory.

public:
 static IntPtr StringToHGlobalUni(System::String ^ s);
[System.Security.SecurityCritical]
public static IntPtr StringToHGlobalUni (string s);
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ódigos gerenciados e não gerenciados.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 de 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.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Aplica-se a

Veja também