FormatMessage的用法

http://blog.163.com/fifa___2008/blog/static/23948589200885114812139/

FormatMessage的用法

2008-09-05 11:48:12| 分类： c/c++/vc | 标签： |字号大中小 订阅

根据一个错误码返回一个错误讯息

DWORD FormatMessage(

DWORD dwFlags,

LPCVOID lpSource,

DWORD dwMessageId,

DWORD dwLanguageId,

LPTSTR lpBuffer,

DWORD nSize,

va_list* Arguments

);

dwFlags:

# FORMAT_MESSAGE_ALLOCATE_BUFFER // 此函数会分配内存以包含描述字串。

# FORMAT_MESSAGE_FROM_SYSTEM, // 在系统的id映射表中寻找描述字串

# FORMAT_MESSAGE_FROM_HMODULE // 在其他资源模块中寻找描述字串

# FORMAT_MESSAGE_FROM_STRING // 消息ID是个字串，不是个DWORD

通常为：FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM

lpSource:

# 指定了FORMAT_MESSAGE_FROM_HMODULE的话，此参数表示模块的HANDLE

# 指定了FORMAT_MESSAGE_FROM_STRING的话，此参数表示id字串

通常为：NULL

dwMessageId:

消息ID;如果指定FORMAT_MESSAGE_FROM_STRING，将被忽略。

dwLanguageId:

消息描述所用的语言

通常为：0表示自动选择

lpBuffer:

#如果未指定FORMAT_MESSAGE_ALLOCATE_BUFFER，则为自己提供的缓冲区

#否则为系统LocalAlloc分配，需要被用户LocalFree

nSize:

#如果未指定FORMAT_MESSAGE_ALLOCATE_BUFFER，则为自己提供的缓冲区大小

#否则为系统LocalAlloc分配之最小缓冲区大小

Arguments:

通常不使用

下面是个例子：

TCHAR* buffer;

DWORD error = ERROR_DS_OBJ_STRING_NAME_EXISTS;

::FormatMessage(

FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM,

NULL,

error,

0,

( LPTSTR )&buffer,

0,

NULL );

::MessageBox( NULL, buffer, NULL, 0 );

LocalFree( buffer );