Marshal.StringToHGlobalAuto(String) 메서드

정의

필요할 때 ANSI 형식으로 변환하여 관리되는 String의 내용을 관리되지 않는 메모리로 복사합니다.Copies the contents of a managed String into unmanaged memory, converting into ANSI format if required.

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

매개 변수

s
String

복사할 관리되는 문자열입니다.A managed string to be copied.

반환

IntPtr

관리되지 않는 메모리에서 문자열이 복사된 주소이거나 snull인 경우 0입니다.The address, in unmanaged memory, to where the string was copied, or 0 if s is null.

특성

예외

사용 가능한 메모리가 부족한 경우There is insufficient memory available.

예제

다음 예제에서는 관리 되는 클래스의 내용을 관리 String 되지 않는 메모리로 변환한 다음 작업을 수행할 때 관리 되지 않는 메모리를 삭제 하는 방법을 보여 줍니다.The following example demonstrates how to convert the contents of a managed String class to unmanaged memory and then dispose of the unmanaged memory when done.

using namespace System;
using namespace System::Runtime::InteropServices;

int main()
{
    // Create a managed string.
    String^ managedString = "Hello unmanaged world (from the managed world).";

    // Marshal the managed string to unmanaged memory.
    char*  stringPointer = (char*) Marshal::StringToHGlobalAuto(managedString).ToPointer();

    // Pass the string to an unmanaged API.

    // Always free the unmanaged string.
    Marshal::FreeHGlobal(IntPtr(stringPointer));

    return 0;
}

설명

StringToHGlobalAuto 는 관리 코드와 비관리 코드를 혼합할 때 사용자 지정 마샬링 또는 사용에 유용 합니다.StringToHGlobalAuto is useful for custom marshaling or for use when mixing managed and unmanaged code. 이 메서드는 문자열에 필요한 관리 되지 않는 메모리를 할당 하므로 항상를 호출 하 여 메모리를 비웁니다 FreeHGlobal .Because this method allocates the unmanaged memory required for a string, always free the memory by calling FreeHGlobal. 이 메서드는의 반대 기능을 제공 합니다 Marshal.PtrToStringAuto .This method provides the opposite functionality of Marshal.PtrToStringAuto.

이 메서드는 포함 된 null 문자를 복사 하 고는 종료 null 문자를 포함 합니다.This method copies embedded null characters, and includes a terminating null character.

적용 대상

추가 정보