Microsoft MVP성태의 닷넷 이야기
닷넷: 2268. C# 코드에서 MAKEINTREOURCE 매크로 처리 [링크 복사], [링크+제목 복사],
조회: 9281
글쓴 사람
정성태 (seongtaejeong at gmail.com)
홈페이지
첨부 파일
 

C# 코드에서 MAKEINTREOURCE 매크로 처리

C/C++ 코드를 포팅하려는데 MAKEINTREOURCE가 나오면 어떻게 해야 할까요? ^^

예를 들어, Win32의 각종 리소스 타입은 MAKEINTRESOURCE 매크로를 이용한 식별자입니다.

#define RT_CURSOR           MAKEINTRESOURCE(1)
#define RT_BITMAP           MAKEINTRESOURCE(2)
#define RT_ICON             MAKEINTRESOURCE(3)
#define RT_MENU             MAKEINTRESOURCE(4)
#define RT_DIALOG           MAKEINTRESOURCE(5)
#define RT_STRING           MAKEINTRESOURCE(6)
#define RT_FONTDIR          MAKEINTRESOURCE(7)
#define RT_FONT             MAKEINTRESOURCE(8)
#define RT_ACCELERATOR      MAKEINTRESOURCE(9)
#define RT_RCDATA           MAKEINTRESOURCE(10)
#define RT_MESSAGETABLE     MAKEINTRESOURCE(11)

MAKEINTRESOURCE 정의는 간단한데,

#define MAKEINTRESOURCEA(i) ((LPSTR)((ULONG_PTR)((WORD)(i))))
#define MAKEINTRESOURCEW(i) ((LPWSTR)((ULONG_PTR)((WORD)(i))))
#ifdef UNICODE
#define MAKEINTRESOURCE  MAKEINTRESOURCEW
#else
#define MAKEINTRESOURCE  MAKEINTRESOURCEA
#endif // !UNICODE

단순히 정숫값을 그대로 문자열 포인터로 취급하도록 형변환하는 역할만 합니다. 얼핏 보면 쓸데없는 매크로인 듯하지만 이렇게 된 주요 원인은 C 언어가 함수 오버로딩을 지원하지 않기 때문입니다.

예를 들어, MAKEINTRESOURCE를 사용한 예제를 보면,

// LoadAccelerators function (winuser.h)
// ; https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-loadacceleratorsw

함수 원형: HACCEL LoadAcceleratorsW([in, optional] HINSTANCE hInstance, [in] LPCWSTR lpTableName);

호출 예제: HACCEL hAccelTable = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDC_PROJECT1));

LoadAccelerators 함수는 2번째 인자로 LPCWSTR 문자열 타입을 받게 돼 있습니다. 하지만 마이크로소프트는 2바이트 정수 형식의 식별자도 간단하게 쓰고 싶었고, 이를 위해 정수를 받는 또 다른 함수를 LoadAccelerators2로 만들어야 했겠지만 그것을 우회해서 그냥 정수를 문자열이라고 받아들이도록 강제 형변환을 하는 선택을 한 것입니다.

사실, 단순하게 개발자들로 하여금 알아서 형변환을 하도록 강제해도 좋았을 것입니다.

HACCEL hAccelTable = LoadAccelerators(hInstance, (LPCWSTR)IDC_PROJECT1);

당연히 저렇게 해도 동작은 하는데요, 좀 더 강제적으로 16비트 식별자를 문자열로 취급하도록 나름 도우미 형식으로 매크로 함수를 만들어 둔 것이고 그 이름이 MAKEINTRESOURCE일 뿐입니다.

결국, C# 코드로 포팅한다면 그냥 ushort 범위의 숫자로 사용해도 무방합니다. 예를 들어, MAKEINTRESOURCE(1)은 그냥 (ushort)1로 쓰면 됩니다.




혹시나 해서 oldnewthing 블로그를 찾아보니, 역시나 글이 있군요. ^^

How can I tell that somebody used the MAKEINTRESOURCE macro to smuggle an integer inside a pointer?
; https://devblogs.microsoft.com/oldnewthing/20130925-00/?p=3123

이름에 INT가 들어가 있긴 하지만 좀 더 엄밀히는 16비트 정수인 WORD인데요, 왜 하필 이 영역이 일반적인 포인터와 혼동하지 않고 안전하게 식별자로 사용할 수 있는지에 대한 이유가 나옵니다. 설명으로는, Windows 7부터 64KB 이하의 영역은 절대 유효한 메모리로 매핑시키지 못하도록 만들었기 때문이라고 하는데요, 근데, 좀 이상합니다. MAKEINTRESOURCE 매크로는 그 훨씬 전인 16비트 윈도우 시절부터 나온 것인데, 뜬금없이 Windows 7이 나옵니다. ^^;

게다가 더 이상한 것은, 16비트지만 상위 1비트는 0이어서 실제 범위는 0x0000 ~ 0x7FFF가 됩니다. 즉, 64KB가 아니라 32KB 이하가 됩니다. 아마도 이것이야말로 16비트 윈도우 시절과 관련된 제약이었을 듯합니다.

추가적으로, 이름에 "RESOURCE"가 붙긴 하지만, 그것과는 무관한 Get­Proc­Address에도 Ordinal로 함수를 찾을 경우 사용이 되기도 합니다. 그러니까, 아마도 그런 것까지 종합해 고려한다면 MAKEINTRESOURCE라고 읽고 "INT_TO_BARE_PTR_15BITS"라고 이해하시는 것이 좋을 듯합니다. ^^




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







[최초 등록일: ]
[최종 수정일: 6/23/2024]

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)
13959정성태6/25/2025988오류 유형: 966. Ubuntu - ping: connect: Network is unreachable
13958정성태6/21/20251480닷넷: 2339. C# - Phi-4-multimodal 모델의 GPU 가속 방법 (ORT 사용)파일 다운로드1
13957정성태6/20/20251437닷넷: 2338. C# / Foundry Local - Phi-4-multimodal 모델을 사용하는 방법
13956정성태6/19/20251609개발 환경 구성: 751. Triton Inference Server의 Python Backend 프로세스
13955정성태6/18/20251755오류 유형: 965. Hugging Face 모델 다운로드 시 "requests.exceptions.HTTPError: 401 Client Error: Unauthorized for url: ..." 오류
13954정성태6/18/20251564닷넷: 2337. C# - Hugging Face에 공개된 LLM 모델을 Foundry Local에서 사용하는 방법파일 다운로드1
13953정성태6/16/20251399스크립트: 78. 파이썬 - 소스 코드의 파일 경로를 지정한 모듈 로드
13952정성태6/15/20251741닷넷: 2336. C# - IValueTaskSource로 인해 주의가 필요한 ValueTask 호출파일 다운로드1
13951정성태6/15/20251623오류 유형: 964. Outlook - 일정이 "You cannot make changes to contents of this read-only folder." 오류 메시지로 삭제가 안 되는 경우
13950정성태6/12/20252071닷넷: 2335. C# - 간단하게 구현해 보는 IValueTaskSource 예제파일 다운로드1
13949정성태6/11/20251804오류 유형: 963. SignTool - "Error: SignerSign() failed." (-2146869243/0x80096005)
13948정성태6/10/20251411오류 유형: 962. 파이썬 - Linux 환경 + TCP 서버 소켓을 사용하는 프로세스 종료 후 재실행하는 경우 "OSError: [Errno 98] Address already in use" 오류 발생
13947정성태6/9/20251901개발 환경 구성: 750. 파이썬 - Azure App Service에 응용 프로그램 배포 후의 환경
13946정성태6/9/20252014개발 환경 구성: 749. 파이썬 - Azure App Service에 응용 프로그램 배포하기 전의 환경
13945정성태6/7/20251722오류 유형: 961. 파이썬 + conda - mysqlclient 사용 시 "NameError: name '_mysql' is not defined" 에러
13944정성태6/7/20255464오류 유형: 960. The trust relationship between this workstation and the primary domain failed. - 네 번째 이야기
13943정성태6/6/20252073개발 환경 구성: 748. Windows + Foundry Local - 로컬에서 AI 모델 활용 [1]
13942정성태6/5/20251686오류 유형: 959. winget 설치 시 "0x80d02002 : unknown error"
13941정성태6/2/20251508닷넷: 2334. C# - cpuid 명령어를 이용한 CPU 제조사 문자열 가져오기파일 다운로드1
13940정성태6/1/20251947C/C++: 188. C++의 32비트 + Release 어셈블리 코드를 .NET으로 포팅할 때 주의할 점파일 다운로드1
13939정성태5/29/20252284오류 유형: 958. NVIDIA Triton Inference Server - version `GLIBCXX_3.4.32' not found (required by /opt/tritonserver/backends/python/triton_python_backend_stub)
13938정성태5/29/20251779개발 환경 구성: 747. 파이썬 - WSL/docker에 구성한 Triton 예제 개발 환경
13937정성태5/24/20251693개발 환경 구성: 746. Windows + WSL2 환경에서 (tensorflow 등의) NVIDIA GPU 인식
13936정성태5/23/20251571개발 환경 구성: 745. Linux / WSL 환경에 Miniconda 설치하기
13935정성태5/20/20251734오류 유형: 957. 파이썬 - pip 사용 시 "ImportError: cannot import name 'html5lib' from 'pip._vendor'" 오류
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...