Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일

C# - x86/x64 환경에 따라 달라지는 P/Invoke 함수의 export 이름

다음의 글은,

C# - x86 실행 환경에서 SECURITY_ATTRIBUTES 구조체를 CreateEvent에 전달할 때 예외 발생
; https://www.sysnet.pe.kr/2/0/11130

사실, 제가 CreateEvent Win32 API를 P/Invoke 테스트하면서 첫 번째 인자를 실수로 포인터가 아닌 구조체 값을 그대로 전달해 발생한 문제입니다. 재미있는 것은, 저 글에 대한 재현 소스 코드를 작성하면서 희한한 현상으로 보이는 ^^; 문제를 접하게 되었는데 그에 대해 하나씩 풀어낸 과정을 기록해 보겠습니다.




현상을 설명하기 위해, 우선 C++로 다음의 소스 코드를 가진 Win32 DLL 프로젝트를 준비합니다.

// Header 파일
#pragma pack( push, 1 )
struct TESTATTR
{
    int Age;
    int *Dummy;
};
#pragma pack(pop)

extern "C"
{
    __declspec(dllexport) void __stdcall fnWin32Project1(TESTATTR *pAttr);
}

// 소스 코드 파일
#include "stdafx.h"
#include <stdio.h>
#include "Win32Project1.h"

__declspec(dllexport) void __stdcall fnWin32Project1(TESTATTR *pAttr)
{
    printf("C++: %d, %d\n", pAttr->Age, pAttr->Dummy);

    pAttr->Age++;
    pAttr->Dummy++;
}

주의해서 볼 것은, TESTATTR 구조체를 받는 형식이 포인터라는 점입니다. 그다음, C#에서는 C++의 DLL에서 export시킨 fnWin32Project1을 사용하되,

using System;
using System.Runtime.InteropServices;

class Program
{
    [StructLayout(LayoutKind.Sequential, Pack = 1)]
    public struct TESTATTR
    {
        public int Age;
        public IntPtr Dummy;
    }

    [DllImport("Win32Project1.dll", CharSet = CharSet.Auto, SetLastError = true)]
    internal static extern void fnWin32Project1(TESTATTR attr);

    static void Main(string[] args)
    {
        TESTATTR testAttr = new TESTATTR();

        testAttr.Age = 2;
        testAttr.Dummy = new IntPtr(5);

        fnWin32Project1(testAttr);

        Console.WriteLine(string.Format("C#: {0}, {1}", testAttr.Age, testAttr.Dummy));
    }
}

보는 바와 같이 (포인터가 아닌) 구조체 그대로 받는 것입니다. 이렇게 하고 x86 빌드로 실행하면 fnWin32Project1에서 다음과 같은 예외가 발생합니다.

An unhandled exception of type 'System.EntryPointNotFoundException' occurred in NullDaclEvent.exe

Additional information: Unable to find an entry point named 'fnWin32Project1' in DLL 'Win32Project1.dll'.

반면, x64로 빌드하면 정상적인 것처럼 실행됩니다.

여기서 이상한 점은, 왜? x86에서는 해당 API를 못 찾는다고 하고, 반면 x64에서는 잘 찾아서 호출에 성공한 것일까요?

이유는, x86의 경우 Win32 DLL 측에서 fnWin32Project1 함수에 대한 export 이름을 (stdcall 호출 규약에 따라) 다음과 같이 설정하기 때문입니다.

_fnWin32Project1@4

그런데, C# 측의 DllImport에서는 첫 번째 인자를 구조체로 전달했으므로 그 크기에 따라 "_fnWin32Project1@8" 함수를 찾으려 하므로 EntryPointNotFoundException 오류가 발생합니다. 하지만 x64 빌드에서는 모든 호출 규약이 fastcall로 정리가 되었으므로 무조건 export 이름을 "fnWin32Project1"로 정하기 때문에 C#의 호출 코드에서 문제없이 함수를 찾을 수 있고 운 좋게 실행까지 된 것입니다.




그런데, 한 가지 의문이 더 남습니다. 그렇다면 CreateEvent를 호출했을 때는 왜? x86 환경에서 EntryPointNotFoundException이 발생하지 않았냐는 것입니다.

그것은, Windows DLL들의 경우 함수들이 dllexport가 아닌, "def" 파일 내에 정의를 해 export 하므로,

LIBRARY

EXPORTS
   ...[생략]...
   CreateEventW
   ...[생략]...

mangling 이름이 "_CreateEventW@16"이 아닌 "CreateEventW"로 되기 때문에 C# 측에서도 정상적으로 찾을 수 있었던 것입니다.

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




정리해 보면, x64 C# 응용 프로그램의 경우 Win32 API에 대한 P/Invoke DllImport 구문을 신경 써서 잘 확인해야 합니다. (저처럼, 무심코 포인터 인자를 그냥 구조체로 넘겨 주면 해석할 수 없는 오류로 고생할 수 있습니다. ^^;)

참고로, 다음의 글도 읽어보시고.

C# 개발자를 위한 Win32 DLL export 함수의 호출 규약 (3) - x64 환경의 __fastcall과 Name mangling
; https://www.sysnet.pe.kr/2/0/11139




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







[최초 등록일: ]
[최종 수정일: 10/20/2020]

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

비밀번호

댓글 작성자
 



2024-12-17 01시08분
Why do we have header files <pshpackN.h> and <poppack.h> instead of just issuing the pragma directly?
; https://devblogs.microsoft.com/oldnewthing/20241216-00/?p=110645

MSVC 고유 확장의 #pragma pack 지시자보다는 다중 플랫폼을 고려한다면 <pshpackN.h> / <poppack.h> 조합을 쓰는 것을 권장합니다.
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13883정성태2/12/2025191닷넷: 2317. C# - Memory Mapped I/O를 이용한 PCI Configuration Space 정보 열람파일 다운로드1
13882정성태2/10/2025591스크립트: 70. 파이썬 - oracledb 패키지 연동 시 Thin / Thick 모드
13881정성태2/7/2025912닷넷: 2316. C# - Port I/O를 이용한 PCI Configuration Space 정보 열람파일 다운로드1
13880정성태2/5/2025873오류 유형: 947. sshd - Failed to start OpenSSH server daemon.
13879정성태2/5/20251109오류 유형: 946. Ubuntu - N: Updating from such a repository can't be done securely, and is therefore disabled by default.
13878정성태2/3/2025988오류 유형: 945. Windows - 최대 절전 모드 시 DRIVER_POWER_STATE_FAILURE 발생 (pacer.sys)
13877정성태1/25/20251083닷넷: 2315. C# - PCI 장치 열거 (레지스트리, SetupAPI)파일 다운로드1
13876정성태1/25/20251275닷넷: 2314. C# - ProcessStartInfo 타입의 Arguments와 ArgumentList파일 다운로드1
13875정성태1/24/20251264스크립트: 69. 파이썬 - multiprocessing 패키지의 spawn 모드로 동작하는 uvicorn의 workers
13874정성태1/24/20251212스크립트: 68. 파이썬 - multiprocessing Pool의 기본 프로세스 시작 모드(spawn, fork)
13873정성태1/23/20251107디버깅 기술: 217. WinDbg - PCI 장치 열거
13872정성태1/23/20251089오류 유형: 944. WinDbg - 원격 커널 디버깅이 연결은 되지만 Break (Ctrl + Break) 키를 눌러도 멈추지 않는 현상
13871정성태1/22/20251202Windows: 278. Windows - 윈도우를 다른 모니터 화면으로 이동시키는 단축키 (Window + Shift + 화살표)
13870정성태1/18/20251275개발 환경 구성: 741. WinDbg - 네트워크 커널 디버깅이 가능한 NIC 카드 지원 확대
13869정성태1/18/20251329개발 환경 구성: 740. WinDbg - _NT_SYMBOL_PATH 환경 변수에 설정한 경로로 심벌 파일을 다운로드하지 않는 경우
13868정성태1/17/20251234Windows: 277. Hyper-V - Windows 11 VM의 Enhanced Session 모드로 로그인을 할 수 없는 문제
13867정성태1/17/20251396오류 유형: 943. Hyper-V에 Windows 11 설치 시 "This PC doesn't currently meet Windows 11 system requirements" 오류
13866정성태1/16/20251361개발 환경 구성: 739. Windows 10부터 바뀐 device driver 서명 방법
13865정성태1/15/20251478오류 유형: 942. C# - .NET Framework 4.5.2 이하의 버전에서 HttpWebRequest로 https 호출 시 "System.Net.WebException" 예외 발생
13864정성태1/15/20251428Linux: 114. eBPF를 위해 필요한 SELinux 보안 정책
13863정성태1/14/20251321Linux: 113. Linux - 프로세스를 위한 전용 SELinux 보안 문맥 지정
13862정성태1/13/20251284Linux: 112. Linux - 데몬을 위한 SELinux 보안 정책 설정
13861정성태1/11/20251792Windows: 276. 명령행에서 원격 서비스를 동기/비동기로 시작/중지
13860정성태1/10/20251741디버깅 기술: 216. WinDbg - 2가지 유형의 식 평가 방법(MASM, C++)
13859정성태1/9/20251851디버깅 기술: 215. Windbg - syscall 이후 실행되는 KiSystemCall64 함수 및 SSDT 디버깅
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...