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

비밀번호

댓글 작성자
 




1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13829정성태11/25/20246693스크립트: 67. 파이썬 - Windows 버전에서 함께 설치되는 py.exe
13828정성태11/25/20245202개발 환경 구성: 735. Azure - 압축 파일을 이용한 web app 배포 시 디렉터리 구분이 안 되는 문제파일 다운로드1
13827정성태11/25/20246023Windows: 273. Windows 환경의 파일 압축 방법 (tar, Compress-Archive)
13826정성태11/21/20246394닷넷: 2313. C# - (비밀번호 등의) Console로부터 입력받을 때 문자열 출력 숨기기(echo 끄기)파일 다운로드1
13825정성태11/21/20247050Linux: 110. eBPF / bpf2go - BPF_RINGBUF_OUTPUT / BPF_MAP_TYPE_RINGBUF 사용법
13824정성태11/20/20245427Linux: 109. eBPF / bpf2go - BPF_PERF_OUTPUT / BPF_MAP_TYPE_PERF_EVENT_ARRAY 사용법
13823정성태11/20/20246628개발 환경 구성: 734. Ubuntu에 docker, kubernetes (k3s) 설치
13822정성태11/20/20246499개발 환경 구성: 733. Windbg - VirtualBox VM의 커널 디버거 연결 시 COM 포트가 없는 경우
13821정성태11/18/20246100Linux: 108. Linux와 Windows의 프로세스/스레드 ID 관리 방식
13820정성태11/18/20246558VS.NET IDE: 195. Visual C++ - C# 프로젝트처럼 CopyToOutputDirectory 항목을 추가하는 방법
13819정성태11/15/20245132Linux: 107. eBPF - libbpf CO-RE의 CONFIG_DEBUG_INFO_BTF 빌드 여부에 대한 의존성
13818정성태11/15/20246685Windows: 272. Windows 11 24H2 - sudo 추가
13817정성태11/14/20245897Linux: 106. eBPF / bpf2go - (BPF_MAP_TYPE_HASH) Map을 이용한 전역 변수 구현
13816정성태11/14/20246853닷넷: 2312. C#, C++ - Windows / Linux 환경의 Thread Name 설정파일 다운로드1
13815정성태11/13/20245469Linux: 105. eBPF - bpf2go에서 전역 변수 설정 방법
13814정성태11/13/20246119닷넷: 2311. C# - Windows / Linux 환경에서 Native Thread ID 가져오기파일 다운로드1
13813정성태11/12/20246665닷넷: 2310. .NET의 Rune 타입과 emoji 표현파일 다운로드1
13812정성태11/11/202410284오류 유형: 933. Active Directory - The forest functional level is not supported.
13811정성태11/11/20245858Linux: 104. Linux - COLUMNS 환경변수가 언제나 80으로 설정되는 환경
13810정성태11/10/20246884Linux: 103. eBPF (bpf2go) - Tracepoint를 이용한 트레이스 (BPF_PROG_TYPE_TRACEPOINT)
13809정성태11/10/20246517Windows: 271. 윈도우 서버 2025 마이그레이션
13808정성태11/9/20246833오류 유형: 932. Linux - 커널 업그레이드 후 "error: bad shim signature" 오류 발생
13807정성태11/9/20245684Linux: 102. Linux - 커널 이미지 파일 서명 (Ubuntu 환경)
13806정성태11/8/20245869Windows: 270. 어댑터 상세 정보(Network Connection Details) 창의 내용이 비어 있는 경우
13805정성태11/8/20245474오류 유형: 931. Active Directory의 adprep 또는 복제가 안 되는 경우
13804정성태11/7/20247071Linux: 101. eBPF 함수의 인자를 다루는 방법
1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...