Marshal.StringToCoTaskMemAnsi(String) 메서드

정의

네임스페이스:

System.Runtime.InteropServices

어셈블리:

System.Runtime.InteropServices.dll

어셈블리:

mscorlib.dll

어셈블리:

netstandard.dll

관리되는 String의 내용을 관리되지 않는 COM 작업 할당자에서 할당된 메모리 블록으로 복사합니다.

public:
 static IntPtr StringToCoTaskMemAnsi(System::String ^ s);

[System.Security.SecurityCritical]
public static IntPtr StringToCoTaskMemAnsi (string s);

public static IntPtr StringToCoTaskMemAnsi (string? s);

public static IntPtr StringToCoTaskMemAnsi (string s);

[<System.Security.SecurityCritical>]
static member StringToCoTaskMemAnsi : string -> nativeint

static member StringToCoTaskMemAnsi : string -> nativeint

Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr

매개 변수

s

String

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

반환

IntPtr

nativeint

문자열에 할당된 메모리 블록에 대한 포인터를 나타내는 정수이거나 s가 null인 경우 0입니다.

특성

SecurityCriticalAttribute

예외

OutOfMemoryException

사용 가능한 메모리가 부족한 경우

ArgumentOutOfRangeException

s 매개 변수가 운영 체제에서 허용되는 최대 길이를 초과하는 경우

설명

StringToCoTaskMemAnsi 는 사용자 지정 마샬링 또는 관리 코드와 관리되지 않는 코드를 혼합하는 경우에 유용합니다. 이 메서드는 문자열에 필요한 관리되지 않는 메모리를 할당하므로 항상 호출 FreeCoTaskMem하여 메모리를 해제합니다. 이 메서드는 .의 Marshal.PtrToStringAnsi반대 기능을 제공합니다. 문자열의 문자는 ANSI 문자로 복사됩니다.

추가 정보

• FreeCoTaskMem(IntPtr)
• PtrToStringAnsi(IntPtr)