Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)
(시리즈 글이 13개 있습니다.)
.NET Framework: 397. C# - OCX 컨트롤에 구현된 메서드에 배열을 in, out으로 전달하는 방법
; https://www.sysnet.pe.kr/2/0/1547

.NET Framework: 652. C# 개발자를 위한 C++ COM 객체의 기본 구현 방식 설명
; https://www.sysnet.pe.kr/2/0/11175

.NET Framework: 792. C# COM 서버가 제공하는 COM 이벤트를 C++에서 받는 방법
; https://www.sysnet.pe.kr/2/0/11679

.NET Framework: 907. C# DLL로부터 TLB 및 C/C++ 헤더 파일(TLH)을 생성하는 방법
; https://www.sysnet.pe.kr/2/0/12220

.NET Framework: 977. C# PInvoke - C++의 매개변수에 대한 마샬링을 tlbexp.exe를 이용해 확인하는 방법
; https://www.sysnet.pe.kr/2/0/12443

.NET Framework: 1008. 배열을 반환하는 C# COM 개체의 메서드를 C++에서 사용 시 메모리 누수 현상
; https://www.sysnet.pe.kr/2/0/12491

.NET Framework: 1064. C# COM 개체를 PIA(Primary Interop Assembly)로써 "Embed Interop Types" 참조하는 방법
; https://www.sysnet.pe.kr/2/0/12662

.NET Framework: 1069. C# - DLL Surrogate를 이용한 Out-of-process COM 개체 제작
; https://www.sysnet.pe.kr/2/0/12668

.NET Framework: 1095. C# COM 개체를 C++에서 사용하는 예제
; https://www.sysnet.pe.kr/2/0/12791

.NET Framework: 2003. C# - COM 개체의 이벤트 핸들러에서 발생하는 예외에 대한 CLR의 특별 대우
; https://www.sysnet.pe.kr/2/0/13050

닷넷: 2177. C# - (Interop DLL 없이) CoClass를 이용한 COM 개체 생성 방법
; https://www.sysnet.pe.kr/2/0/13469

닷넷: 2248. C# - 인터페이스 타입의 다중 포인터를 인자로 갖는 C/C++ 함수 연동
; https://www.sysnet.pe.kr/2/0/13607

닷넷: 2254. C# - COM 인터페이스의 상속 시 중복으로 메서드를 선언
; https://www.sysnet.pe.kr/2/0/13614




C# PInvoke - C++의 매개변수에 대한 마샬링을 tlbexp.exe를 이용해 확인하는 방법

예전에, C# DLL -> TLB -> CPP 헤더 파일로 변환하는 방법을 설명했었는데요,

C# DLL로부터 TLB 및 C/C++ 헤더 파일(TLH)을 생성하는 방법
; https://www.sysnet.pe.kr/2/0/12220

우연히 다음의 글을 읽으면서,

The confusing UnmanagedType.LPStruct marshaling directive
; https://learn.microsoft.com/en-us/archive/blogs/adam_nathan/the-confusing-unmanagedtype-lpstruct-marshaling-directive

Note that the type library exporter (TLBEXP.EXE) is a great tool for statically understanding how managed parameters/fields/return types get marshaled, since the signatures created by the exporter are required to match what the marshaler does at run-time. Even if you're wondering about the parameters of a PInvoke method, you can do this trick by temporarily pasting the method into a public interface (removing the "static", "extern", etc.) then running TLBEXP.EXE on your assembly.


C# 메서드의 매개변수가 어떻게 C++ 함수에 대응하는지 쉽게 파악하는 도구로도 사용될 수 있다는 것을 깨달았습니다. ^^; 가령, 만약에 여러분이 호출해야 할 C++의 함수와 그것의 인자에 들어가는 구조체를 보고,

struct MyStruct
{
    int Age;
    char* ptrName;
    char* ptrAddr;
    char Name[80];
};

__declspec(dllexport) void __stdcall TestMethod(MyStruct* pAttr);

다음과 같이 C# 코드로 맞췄다고 가정해 보겠습니다.

public struct MyStruct
{
    public int Age;
    public IntPtr ptrName;
    public IntPtr ptrAddr;
    public char[] Name;
}

public class Test
{
    [DllImport("test.dll")]
    static extern void TestMethod(ref MyStruct pAttr);
}

이때 저 함수와 구조체의 정의가 실제로 C++의 것과 일치하는지 직접 확인하고 싶다면 tlbexp.exe를 이용할 수 있습니다. 실습을 위해 간단한 더미 C# DLL 프로젝트를 하나 만들고, 그 안에 위의 코드를 복사해 interface를 구성한 후,

using System;
using System.Runtime.InteropServices;

[assembly: ComVisible(true)]

namespace ClassLibrary1
{
    public struct MyStruct
    {
        public int Age;
        public IntPtr ptrName;
        public IntPtr ptrAddr;
        public char[] Name;
    }

    [Guid("2AFBAFEE-68A9-4EF8-A38C-A7941D47CC16")]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IMyInteropTest
    {
        [DispId(1)]
        void TestMethod(ref MyStruct pAttr);
    }
}

빌드 결과물인 DLL을 tlbexp.exe에 넘기면 Type Library(tlb) 파일이 생성됩니다.

C:\temp> tlbexp ClassLibrary1.dll

마지막으로 tlb 파일을 oleview.exe를 이용해 C++로 번역된 결과를 볼 수 있습니다.

[
  uuid(B833A7ED-D142-4FDA-9474-6C536851852B),
  version(1.0),
  custom(90883F05-3D28-11D2-8F17-00A0C9A6186D, "ClassLibrary1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null")
]
library ClassLibrary1
{
    importlib("stdole2.tlb");
    interface IMyInteropTest;
    typedef [uuid(F2947813-305C-3BB1-BA28-FCD9B7A01162), version(1.0)    ,
      custom(0F21F359-AB84-41E8-9A78-36D110E6D2F9, "ClassLibrary1.MyStruct")    
]

struct tagMyStruct {
    long Age;
    long ptrName;
    long ptrAddr;
    SAFEARRAY(unsigned char) Name;
} MyStruct;

    [
      odl,
      uuid(2AFBAFEE-68A9-4EF8-A38C-A7941D47CC16),
      version(1.0),
      oleautomation,
      custom(0F21F359-AB84-41E8-9A78-36D110E6D2F9, "ClassLibrary1.IMyInteropTest")    
    ]
    interface IMyInteropTest : IUnknown {
        HRESULT _stdcall TestMethod([in, out] MyStruct* pAttribute);
    };
};

"ref MyStruct"는 "MyStruct*"로 대응했으니 원했던 바이고, IntPtr 타입이 long 형으로 변환된 것은 C# DLL을 "Any CPU" 또는 "x86" 대상으로 빌드를 했기 때문입니다. 만약 C# DLL을 "x64" 대상으로 빌드하면 다음과 같이 tagMyStruct의 ptrName, ptrAddr 필드가 int64로 바뀝니다. (Native라는 C++의 환경을 고려하면 IntPtr이 저렇게 변경되는 것은 당연합니다.)

struct tagMyStruct {
    long Age;
    int64 ptrName;
    int64 ptrAddr;
    SAFEARRAY(unsigned char) Name;
} MyStruct;




그나저나 char [] 타입이 기대했던 데로 되지 않았다는 것을 알 수 있습니다. 따라서 바꿔야 할 텐데요, MarshalAs 특성을 이용해 좀 더 정보를 줘야 하는데, 예를 들어 이렇게 (잘못된) 설정을 해보겠습니다.

public struct MyStruct
{
    public int Age;
    public IntPtr ptrName;
    public IntPtr ptrAddr;

    [MarshalAs(UnmanagedType.LPStr, SizeConst = 80)]
    public char[] Name;
}

이후 빌드하고 TLB를 생성하기 위해 tlbexp.exe를 실행하면 다음과 같은 경고를 볼 수 있습니다.

C:\temp\ClassLibrary1\ClassLibrary1\bin\Debug> tlbexp ClassLibrary1.dll
Microsoft (R) .NET Framework Assembly to Type Library Converter 4.8.4084.0
Copyright (C) Microsoft Corporation.  All rights reserved.

TlbExp : warning TX00131175 : When cross-compiling, all type library references should be included on the command line to ensure the correct bit-specific type libraries are loaded.
TlbExp : warning TX801311A6 : Type library exporter warning processing 'ClassLibrary1.MyStruct.Name, ClassLibrary1'. Warning: The method or field has an invalid managed/unmanaged type combination, check the MarshalAs directive.
Assembly exported to 'C:\temp\ClassLibrary1\ClassLibrary1\bin\Debug\ClassLibrary1.tlb'

경고라고 해서 무시하면 안 되는데, 실제로 생성된 tlb를 oleview에서 보면 아예 Name 필드가 누락된 확인할 수 있습니다.

struct tagMyStruct {
    long Age;
    int64 ptrName;
    int64 ptrAddr;
} MyStruct;

즉, "The method or field has an invalid managed/unmanaged type combination, check the MarshalAs directive." 오류는 적절하지 않은 조합으로 MarshalAs 특성 값이 사용돼 해당 필드의 타입을 결정할 수 없게 만든 것입니다. (사실 이러면 ^^; 에러여야 하는데.)

자, 그럼 다시 올바르게 수정해 볼까요?

public struct MyStruct
{
    public int Age;
    public IntPtr ptrName;
    public IntPtr ptrAddr;

    [MarshalAs(UnmanagedType.ByValArray, /* 생략 가능 */ ArraySubType = UnmanagedType.I1, SizeConst = 80)]
    public char[] Name;
}

tlbexp + oleview를 통해 확인까지 하고,

struct tagMyStruct {
    long Age;
    int64 ptrName;
    int64 ptrAddr;
    unsigned char Name[80];
} MyStruct;

따라서 C++ 코드와의 interop이 기대했던 대로 동작할 거라는 것을 예상할 수 있습니다.




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 2/27/2024]

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

비밀번호

댓글 작성자
 




... 121  122  [123]  124  125  126  127  128  129  130  131  132  133  134  135  ...
NoWriterDateCnt.TitleFile(s)
10882정성태1/6/201622440Windows: 113. 윈도우의 2179, 26143, 47001 TCP 포트 사용 [1]
10881정성태1/3/201623435오류 유형: 316. 윈도우 10 - 바탕/돋음 체가 사라져 한글이 깨지는 현상 [2]
10880정성태12/16/201521520오류 유형: 315. 닷넷 프로파일러의 오류 코드 정보
10879정성태12/16/201523389오류 유형: 314. Error : DEP0700 : Registration of the app failed. error 0x80070005
10878정성태12/9/201526545디버깅 기술: 75. UWP(유니버설 윈도우 플랫폼) 앱에서 global::System.Diagnostics.Debugger.Break 예외 발생 시 대응 방법
10877정성태12/9/201530854VC++: 93. std::thread 사용 시 R6010 오류 [2]
10876정성태11/26/201526811.NET Framework: 541. SignedXml을 이용한 ds:Signature만드는 방법 [3]파일 다운로드1
10875정성태11/26/201531960개발 환경 구성: 279. signtool.exe의 다중 서명 기능 [2]
10874정성태11/26/201527664개발 환경 구성: 278. 인증서와 인증서를 이용한 코드 사인의 해시 구분
10873정성태11/25/201526256.NET Framework: 540. C# - 부동 소수 계산 왜 이렇게 나오죠? (2) [3]파일 다운로드1
10872정성태11/24/201534406.NET Framework: 539. C# - 부동 소수 계산 왜 이렇게 나오죠? (1) [1]
10871정성태11/23/201528810오류 유형: 313. SignTool Error: No certificates were found that met all the given criteria.
10870정성태11/23/201530017오류 유형: 312. 윈도우 10 TH2 (버전 1511) 업데이트가 안되는 경우 [1]
10869정성태11/23/201526189오류 유형: 311. certutil 실행 오류 - 0x80070057 [1]
10868정성태11/20/201525578제니퍼 .NET: 25. 제니퍼 닷넷 적용 사례 (5) - RestSharp 라이브러리의 CPU High 현상파일 다운로드1
10867정성태10/18/201528728.NET Framework: 538. Thread.Abort로 인해 프로세스가 종료되는 현상
10866정성태10/14/201523978.NET Framework: 537. C# - Reflection의 박싱 없이 값 형식을 다루는 방법파일 다운로드1
10865정성태10/13/201524317.NET Framework: 536. Thread.Abort의 스레드 종료 지연파일 다운로드1
10864정성태10/12/201522027.NET Framework: 535. aspnet.config 파일의 설정을 읽는 방법
10863정성태10/9/201527606.NET Framework: 534. ASP.NET 응용 프로그램이 예외로 프로세스가 종료된다면?
10862정성태10/9/201525760오류 유형: 310. 비주얼 스튜디오 - Unspecified error (Exception from HRESULT: 0x80004005 (E_FAIL))
10861정성태10/9/201530465기타: 54. 도서: 시작하세요! C# 6.0 프로그래밍: 기본 문법부터 실전 예제까지 (2)
10860정성태10/5/201528160개발 환경 구성: 277. IIS AppPool의 시작/중단에 대한 이벤트 로그 확인 방법
10859정성태10/5/201528570.NET Framework: 533. C#에서 string 형식이 primitive일까요? [6]
10858정성태10/2/201525100VS.NET IDE: 105. Visual Studio의 단위 테스트 작성 시 Fakes를 이용한 메서드 재정의 방법 [1]파일 다운로드1
10857정성태10/1/201521771VS.NET IDE: 104. Visual C++ 프로젝트의 빌드 이벤트에서 환경 변수 사용하는 방법
... 121  122  [123]  124  125  126  127  128  129  130  131  132  133  134  135  ...