Marshal.StringToHGlobalUni(String) Método
Definição
public:
static IntPtr StringToHGlobalUni(System::String ^ s);[System.Security.SecurityCritical]
public static IntPtr StringToHGlobalUni (string s);static member StringToHGlobalUni : string -> nativeintPublic Shared Function StringToHGlobalUni (s As String) As IntPtrParâ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.