向自己的模块添加错误代码_使用vc自带的工具MC创建资源并将其添加至DLL或EXE中

最新推荐文章于 2023-07-24 11:30:44 发布

shanql

最新推荐文章于 2023-07-24 11:30:44 发布

阅读量2.3k

点赞数 2

分类专栏： Win32/MFC

本文链接：https://blog.csdn.net/s634772208/article/details/46402677

版权

Win32/MFC 专栏收录该内容

43 篇文章 3 订阅

订阅专栏

本文主要介绍怎么使用Visual Studio自带的MC.exe工具来创建一个消息资源并将其添加到自己的DLL(或.exe)中，从而达到为自己的模块添加错误代码的目的。

一、MC工具介绍

Message Compiler(MC) 是用来创建消息资源的工具，这些消息资源被DLL(或EXE)模块引用。MC的输入是一个特定格式的文本文件，即*.mc文件，这种特定格式使得在一个文件中定义多种语言支持变得非常容易。

当编写完成一个*.mc文件之后，为了在程序中使用这个文件，你需要一些操作。首先，使用MC工具将这种文件编译成一个*.rc文件（还会生成*.h和*.bin文件）；然后将*.rc及*.h添加进相应的DLL（EXE）模块中编译；最后通过相应的事件日志函数或者FomatMessage函数对其中的消息文本进行使用。（具体的操作过程请看后面的例子）

二、消息文本文件定义（*.mc文件）

1、概述

Messages定义在一个*.mc文件中，MC工具会自动为每条消息赋一个编号，然后会生成一个*.h文件，以供程序引用其中的消息ID。

*.mc文件里定义消息最常见的语法为KEYWORD=VALUE，等号两边的空格会被忽略。下一条类似的定义以空格或者换行来分隔。其中VALUE可以是一个整型常量，或者一个类似宏标识的符号，或者是一个8个字符（或更少）的名字。

2、注释

单行注释：以一个分号开头，然后后面接注释文字，为了在生成的*.h文件中也以注释状态出现，勿必在分号后面撞上一个//。如下：

;//这是一个单行注释

多行注释：每行都以分号开头，但是为了同样的目的，勿必如以下写多行注释：

;/*这是多行注释

;这是多行注释

;这是多行注释*/

3、头部定义块

*.mc文件以头部定义开始，头部定义一些名字标识以及语言标识供后面消息定义使用。头部通常包含以下0个或多个声明（可以是多个相同的声明，比如语言部分）。

MessageIdTypedef=type----用于消息标识定义的类型，如#define name ((type)0xnnnnnnnn) 注：在*.h文件中可看到此类定义。这个类型必须能够容下消息码的范围（32位），比如DWORD。这个类型也可以是程序部分中自定义的。默认状态下是无类型的，也就没有相应的转换。你可以在需要使用这个声明时，才开始定义它。如：MessageIdTypedef=DWORD。

SeverityNames=(name=number[:name])----设置消息码中第31、30位，即Severity部分。

默认的设置如下：

SeverityNames=(

Success=0x0

Informational=0x1

Warning=0x2

Error=0x3

)

FacilityNames=(name=number[:name])----设置消息码中27--16位，即Facility部分，默认的设置如下：

FacilityName=(

System=0x0FF

Application=0xFFF

)

LanguageNames=(name=number:filename)----设置消息所用语言标识，可设置多个语言版本。默认的设置如下：

LanguageNames=(English=1:MSG0001)，其中1可由宏MAKELANGID生成，比如生成简体中文的，MAKELANGID( LAN_CHINES, SUBLANG_CHINESE_SIMPLIFIED)，生成的值为0x804，则我们可以定义LanguageNames=(Chinese=0x804:MSG0804)，其中MSG0804是我们自定义的名字，生成的*.bin文件会以其命令，如MSG0804.bin。

OutputBase=number----生成消息常量数值格式，比如指定16，生成16进制的数，指定10，生成10进制的数等。

4、消息主体定义

消息文本文件包含以下0个或多个声明，其中MessageId标识了一个消息定义的开始，必须存在，Severity、Facility声明是可选的。

MessageId=[number|+number]----消息序号标识，这项必须要有，但是值是可选的。如果没有指定值，此值等于上一个Facility加上1，如果在指定的值前面带上了一个+号，则用上一个Facility加上此值来生成MessageId。

Severity=name----在头部声明FacilityNames指定的一个名字，这个声明是可选的。如果没有指定值，则使用在消息定义块中最后指定的那个值。默认的第一个消息定义是

Facility=Application。

SymbolicName=name----一个标识符，在*.h文件中可看到，如#define name ((type)0xnnnnnnnn)。

OutpubBase={number}----生成消息常量数值格式，比如指定16，生成16进制的数，指定10，生成10进制的数等。

Language=name----在头部声明LanguageNames指定的一个名字，此项是可选项，如果没有指定值，则使用在消息定义块中最后指定的那个值。默认的第一个消息定义是

Language=English。

Message Text----消息文本。

.(点号) ----消息定义终止符，注：此终止符为英文输入模式下输入，否则使用mc工具进行编译时会提示无终止符的。消息定义例子如下：

MessageId=0x1

Severity=Error

Facility=Runtime

SymbolicName=MSG_BAD_COMMAND

Language=English

You have chosen an incorrect command.

Language=Chinese

你选择了一个不正常的命令。

你还可以在消息文本定义中使用一些控制符，具体的可查看MSDN。

三、*.mc文件定义的例子

1、文件内容，文件名字McFile.mc

;//***** Sample.mc *****

;//This is the header section.

MessageIdTypedef=DWORD

SeverityNames=(Success=0x0:STATUS_SEVERITY_SUCCESS
    Informational=0x1:STATUS_SEVERITY_INFORMATIONAL
    Warning=0x2:STATUS_SEVERITY_WARNING
    Error=0x3:STATUS_SEVERITY_ERROR
    )


FacilityNames=(System=0x0:FACILITY_SYSTEM
    Runtime=0x2:FACILITY_RUNTIME
    Stubs=0x3:FACILITY_STUBS
    Io=0x4:FACILITY_IO_ERROR_CODE
)

LanguageNames=(English=0x409:MSG00409)
LanguageNames=(Chinese=0x804:MSG00804)

; // The following are message definitions.


MessageId=0x1
Severity=Error
Facility=Runtime
SymbolicName=MSG_BAD_COMMAND
Language=English
You have chosen an incorrect command.
.
Language=Chinese
你选择了一个不正常的命令。
.

MessageId=0x2
Severity=Warning
Facility=Io
SymbolicName=MSG_BAD_PARM1
Language=English
Cannot reconnect to the server. 
.
Language=Chinese
无法连接服务器。
.

MessageId=0x3
Severity=Success
Facility=System
SymbolicName=MSG_STRIKE_ANY_KEY
Language=English
Press any key to continue . . . %0 
.
Language=Chinese
按任意键继续...
.



MessageId=0x4
Severity=Error
Facility=System
SymbolicName=MSG_CMD_DELETE
Language=English
File %1 contains %2 which is in error 
.
Language=Chinese
文件 %1 包含 %2 r损坏。
.


MessageId=0x5
Severity=Informational
Facility=System
SymbolicName=MSG_RETRYS
Language=English
There have been %1!d! attempts with %2!d!%% success%! Disconnect from the server and try again later. 
.
Language=Chinese
未知错误！无法连接服务器，请稍后重试！
.

2、使用MC工具编译

打开visual studio的命令行界面，进入McFile.mc文件目录，使用命令mc -a -A McFile.mc进行编译，如下：

编译成功后，会在当前目录下生成McFile.h，McFile.rc，MSG00409.bin，MSG00804.bin四个文件，因为文本文件中支持中英文，所以生成了两个*.bin文件。

McFile.h文件部分预览如下：

//***** Sample.mc *****
//This is the header section.
// The following are message definitions.
//
//  Values are 32 bit values layed out as follows:
//
//   3 3 2 2 2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1
//   1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0
//  +---+-+-+-----------------------+-------------------------------+
//  |Sev|C|R|     Facility          |               Code            |
//  +---+-+-+-----------------------+-------------------------------+
//
//  where
//
//      Sev - is the severity code
//
//          00 - Success
//          01 - Informational
//          10 - Warning
//          11 - Error
//
//      C - is the Customer code flag
//
//      R - is a reserved bit
//
//      Facility - is the facility code
//
//      Code - is the facility's status code
//
//
// Define the facility codes
//
#define FACILITY_SYSTEM                  0x0
#define FACILITY_STUBS                   0x3
#define FACILITY_RUNTIME                 0x2
#define FACILITY_IO_ERROR_CODE           0x4


//
// Define the severity codes
//
#define STATUS_SEVERITY_WARNING          0x2
#define STATUS_SEVERITY_SUCCESS          0x0
#define STATUS_SEVERITY_INFORMATIONAL    0x1
#define STATUS_SEVERITY_ERROR            0x3


//
// MessageId: MSG_BAD_COMMAND
//
// MessageText:
//
//  You have chosen an incorrect command.
//
#define MSG_BAD_COMMAND                  ((DWORD)0xC0020001L)

3、将生成的资源文件编译进dll(或exe)模块中。

创建一个WIN32DLL工程，将McFile.h与McFile.rc文件添加进去，进行编译，生成相应的dll即可提供给我们的程序使用。

四、使用自己定义的错误代码，即第三步生成的消息资源模块

#include <iostream>
#include <windows.h>

using namespace std;


//
#ifdef _UNICODE
#define COUT wcout
#else
#define COUT cout
#endif


int main()
{
	DWORD dwError = 0;

	DWORD dwLanguageId = MAKELANGID( LANG_NEUTRAL, SUBLANG_NEUTRAL );

	//解决问题：wcout输出时显示不了中文
	COUT.imbue( std::locale( "chs" ) );

	HLOCAL lpMsgTextBuf = NULL;
	COUT << TEXT("输入一个自定义的错误代码(如:3221356545(0xC0020001) )：");
	while( cin >> dwError )
	{
		lpMsgTextBuf = NULL;

		HMODULE ghResDll = LoadLibrary( TEXT("WinMsgDll.dll") );
		if ( NULL == ghResDll )
		{
			COUT << TEXT("加载消息模块失败！") << endl;
			return -1;
		}


		BOOL bOk = FormatMessage( FORMAT_MESSAGE_FROM_HMODULE | 
			FORMAT_MESSAGE_IGNORE_INSERTS | 
			FORMAT_MESSAGE_ALLOCATE_BUFFER,
			ghResDll, dwError, dwLanguageId, (LPTSTR)&lpMsgTextBuf, 0, NULL );


		if ( !bOk )
		{
			COUT << TEXT("error ") << GetLastError() << endl;
		}

		if ( NULL != lpMsgTextBuf )
		{
			COUT << (LPTSTR)lpMsgTextBuf << endl;
			LocalFree( lpMsgTextBuf );
		}

		COUT << TEXT("输入一个自定义的错误代码(如:3221356545(0xC0020001) )：");
	}
	return 0;
}

五、相应例子visual studio 2005工程文件代码下载

工程文件下载：使用MC工具创建自定义错误代码DLL

作者：山丘儿
转载请标明出处，谢谢。原文地址：http://blog.csdn.net/s634772208/article/details/46402677

shanql

关注

2
点赞
踩
2

收藏

觉得还不错? 一键收藏
0
评论
向自己的模块添加错误代码_使用vc自带的工具MC创建资源并将其添加至DLL或EXE中

本文主要介绍怎么使用Visual Studio自带的MC.exe工具来创建一个消息资源并将其添加到自己的DLL(或.exe)中，从而达到为自己的模块添加错误代码的目的。
复制链接

扫一扫