Marshal.StringToHGlobalAnsi 메서드

아티클
08/21/2007

복사할 때 ANSI 형식으로 변환하여 관리되는 String의 내용을 관리되지 않는 메모리로 복사합니다.

네임스페이스: System.Runtime.InteropServices
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
Public Shared Function StringToHGlobalAnsi ( _
    s As String _
) As IntPtr
‘사용 방법
Dim s As String
Dim returnValue As IntPtr

returnValue = Marshal.StringToHGlobalAnsi(s)

public static IntPtr StringToHGlobalAnsi (
    string s
)

public:
static IntPtr StringToHGlobalAnsi (
    String^ s
)

public static IntPtr StringToHGlobalAnsi (
    String s
)

public static function StringToHGlobalAnsi (
    s : String
) : IntPtr

매개 변수

s
복사할 관리되는 문자열입니다.

반환 값

관리되지 않는 메모리에서 s가 복사된 주소이거나, null 문자열을 제공한 경우 0입니다.

예외

예외 형식	조건
OutOfMemoryException	사용 가능한 메모리가 부족한 경우
ArgumentOutOfRangeException	s 매개 변수가 운영 체제에서 허용되는 최대 길이를 초과하는 경우

설명

StringToHGlobalAnsi는 사용자 지정 마샬링에 사용될 때 또는 관리 코드와 비관리 코드를 함께 사용할 때 유용합니다. 이 메서드는 문자열에 필요한 관리되지 않는 메모리를 할당하므로 항상 FreeHGlobal을 호출하여 메모리를 해제하십시오. StringToHGlobalAnsi는 Marshal.PtrToStringAnsi의 반대 기능을 제공합니다.

참고

이 메서드는 신뢰할 수 없는 코드에서 호출되지 않도록 SecurityAction.LinkDemand를 사용합니다. SecurityPermissionAttribute.UnmanagedCode 권한을 가지려면 직접 실행 호출자만 필요합니다. 부분적으로 신뢰할 수 있는 코드에서 특정 코드를 호출하는 경우 유효성 검사 없이 사용자 입력을 Marshal 클래스 메서드로 전달하지 마십시오. LinkDemand 멤버 사용에 대한 중요한 제한 사항은 Demand와 LinkDemand 비교를 참조하십시오.

예제

다음 코드 예제에서는 관리되는 String 클래스의 내용을 관리되지 않는 메모리로 변환하고 작업을 마친 후 해당 메모리를 삭제하는 방법을 보여 줍니다.

.NET Framework 보안

SecurityPermission 비관리 코드를 호출하는 데 필요한 권한입니다. 연관된 열거형: UnmanagedCode. 보안 동작: LinkDemand

플랫폼

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

Marshal 클래스
Marshal 멤버
System.Runtime.InteropServices 네임스페이스
FreeCoTaskMem
PtrToStringAnsi

다음을 통해 공유