Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 3개 있습니다.)

C# Marshal.PtrToStructure - The structure must not be a value class.

간단한 재현 코드는 다음과 같습니다.

using System;
using System.Runtime.InteropServices;

class Program
{
    static void Main(string[] args)
    {
        int size = Marshal.SizeOf(typeof(MyStruct));
        IntPtr pBuf = Marshal.AllocHGlobal(size);

        MyStruct instance = new MyStruct();

        Marshal.StructureToPtr(instance, pBuf, true);

        // 예외 발생
        Marshal.PtrToStructure(pBuf, instance);
    }
}

public struct MyStruct
{
    public int Age;
    public bool Married;
}

실행하면 다음과 같은 런타임 오류가 발생하는데,

// 처리되지 않은 예외: System.ArgumentException: 구조체는 값 클래스가 아니어야 합니다.

Unhandled Exception: System.ArgumentException: The structure must not be a value class.
Parameter name: structure
   at System.Runtime.InteropServices.Marshal.PtrToStructureHelper(IntPtr ptr, Object structure, Boolean allowValueClasses)
   at Program.Main(String[] args) in C:\ConsoleApp1\ConsoleApp1\Program.cs:line 15

일면 이해가 갑니다. 왜냐하면 값 형식의 특성상 "instance" 변수를 PtrToStructure에 넘겨줬을 때 아무리 발버둥 쳐도 instance에 값을 설정할 방법이 없기 때문입니다. (이게 가능하려면 애당초 ref 유형으로 인자를 전달해야 합니다.) 반면, struct라는 것이 이름에 포함되었다는 점과 대칭적이라는 점에서 한편으론 아쉬움이 남는 API 설계입니다.

이를 위한 해결책으로 2가지가 있습니다. 1) MyStruct를 class로 바꾸거나, 2) PtrToStructure의 또 다른 버전을 사용하는 것입니다.

첫 번째 방법의 경우, 다음과 같이 StructLayout을 지정한 class로 바꾸면 됩니다.

// struct의 경우 기본 LayoutKind가 Sequential
//public struct MyStruct
//{
//    public int Age;
//    public bool Married;
//}

[StructLayout(LayoutKind.Sequential)]
public class MyStruct
{
    public int Age;
    public bool Married;
}

그럼, StructureToPtr에 참조 주소가 복사되어 넘어가기 때문에 대상 메서드에서는 instance 변수의 값을 변경할 수 있습니다.

두 번째 방법이라면 기존 소스 코드의 변경 없이 PtrToStructure 측에서,

instance = (MyStruct)Marshal.PtrToStructure(pBuf, typeof(MyStruct));

아예 반환값으로 넘겨주는 버전을 사용하면 되고, 이 과정에서 박싱/언박싱을 동반하며 instance에 값이 복사됩니다.

(첨부 파일은 이 글의 예제 코드를 포함합니다.)




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 12/9/2020]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 196  [197] 
NoWriterDateCnt.TitleFile(s)
16정성태7/17/200319645COM 개체 관련: 3. IE 툴밴드의 위치문제파일 다운로드1
15정성태7/17/200320635VC++: 5. 시행착오 - 클래스 포인터를 void * 로 대입후 delete 하는 경우.
14정성태7/17/200322198VC++: 4. MFC Message 처리 구조
13정성태7/17/200321946VC++: 3. template 활용의 최고 단계!
12정성태5/7/200619532VC++: 2. void func1( MYCLASS *&pBuildingElement ); 선언의 의미
10정성태7/17/200317866기타: 2. 데브피아 사이트의 클럽 서비스 내에 있는 Standard C++ Research
9정성태7/17/200323441기타: 1. Programming Applications for Microsoft Windows 4th Edition
8정성태7/17/200320826COM 개체 관련: 2. CWindowImpl 의 기본 윈도우 클래스 명을 바꾸려면?
7정성태7/17/200323417VS.NET IDE: 1. VC++ 프로파일링 사용법
4정성태7/17/200335779VC++: 1. C++ 클래스 멤버변수 초기화 [3]
3정성태7/17/200321746스크립트: 2. JScript에서의 Blocking 동작을 막아주는 COM 메서드
2정성태6/14/200640637COM 개체 관련: 1. IWebBrowser2와 IHTMLDocument2의 상호 변환 [2]
1정성태7/17/200324800스크립트: 1. IE 의 훌륭한 저장기능 - userData
... 196  [197]