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

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)
13454정성태11/23/20232735닷넷: 2167. C# - Qdrant Vector DB를 이용한 Embedding 벡터 값 보관/조회 (Azure OpenAI) [1]파일 다운로드1
13453정성태11/23/20232243오류 유형: 879. docker desktop 설치 시 "Invalid JSON string. (Exception from HRESULT: 0x83750007)"
13452정성태11/22/20232325닷넷: 2166. C# - Azure OpenAI API를 이용해 사용자가 제공하는 정보를 대상으로 검색하는 방법파일 다운로드1
13451정성태11/21/20232464닷넷: 2165. C# - Azure OpenAI API를 이용해 ChatGPT처럼 동작하는 콘솔 응용 프로그램 제작파일 다운로드1
13450정성태11/21/20232278닷넷: 2164. C# - Octokit을 이용한 GitHub Issue 검색파일 다운로드1
13449정성태11/21/20232385개발 환경 구성: 688. Azure OpenAI 서비스 신청 방법
13448정성태11/20/20232639닷넷: 2163. .NET 8 - Dynamic PGO를 결합한 성능 향상파일 다운로드1
13447정성태11/16/20232512닷넷: 2162. ASP.NET Core 웹 사이트의 SSL 설정을 코드로 하는 방법
13446정성태11/16/20232435닷넷: 2161. .NET Conf 2023 - Day 1 Blazor 개요 정리
13445정성태11/15/20232754Linux: 62. 리눅스/WSL에서 CA 인증서를 저장하는 방법
13444정성태11/15/20232485닷넷: 2160. C# 12 - Experimental 특성 지원
13443정성태11/14/20232566개발 환경 구성: 687. OpenSSL로 생성한 사용자 인증서를 ASP.NET Core 웹 사이트에 적용하는 방법
13442정성태11/13/20232391개발 환경 구성: 686. 비주얼 스튜디오로 실행한 ASP.NET Core 사이트를 WSL 2 인스턴스에서 https로 접속하는 방법
13441정성태11/12/20232717닷넷: 2159. C# - ASP.NET Core 프로젝트에서 서버 Socket을 직접 생성하는 방법파일 다운로드1
13440정성태11/11/20232406Windows: 253. 소켓 Listen 시 방화벽의 Public/Private 제어 기능이 비활성화된 경우
13439정성태11/10/20232893닷넷: 2158. C# - 소켓 포트를 미리 시스템에 등록/예약해 사용하는 방법(Port Exclusion Ranges)파일 다운로드1
13438정성태11/9/20232492닷넷: 2157. C# - WinRT 기능을 이용해 윈도우에서 실행 중인 Media App 제어
13437정성태11/8/20232681닷넷: 2156. .NET 7 이상의 콘솔 프로그램을 (dockerfile 없이) 로컬 docker에 배포하는 방법
13436정성태11/7/20232942닷넷: 2155. C# - .NET 8 런타임부터 (Reflection 없이) 특성을 이용해 public이 아닌 멤버 호출 가능
13435정성태11/6/20232865닷넷: 2154. C# - 네이티브 자원을 포함한 관리 개체(예: 스레드)의 GC 정리
13434정성태11/1/20232653스크립트: 62. 파이썬 - class의 정적 함수를 동적으로 교체
13433정성태11/1/20232368스크립트: 61. 파이썬 - 함수 오버로딩 미지원
13432정성태10/31/20232428오류 유형: 878. 탐색기의 WSL 디렉터리 접근 시 "Attempt to access invalid address." 오류 발생
13431정성태10/31/20232748스크립트: 60. 파이썬 - 비동기 FastAPI 앱을 gunicorn으로 호스팅
13430정성태10/30/20232647닷넷: 2153. C# - 사용자가 빌드한 ICU dll 파일을 사용하는 방법
13429정성태10/27/20232929닷넷: 2152. Win32 Interop - C/C++ DLL로부터 이중 포인터 버퍼를 C#으로 받는 예제파일 다운로드1
1  2  3  4  5  6  [7]  8  9  10  11  12  13  14  15  ...