Windows核心编程学习一

一、常见的函数返回值数据类型

VOID 函数不可能失败，只有极少数Windows函数的返回值类型为VOID

BOOL 如果函数失败，返回值为0；否则，返回孩子是一个非0值。应避免测试返回值是否为TRUE；最稳妥的做法是检查他/她是否不为FALSE

HANDLE 如果失败返回NULL，否则，HANDLE将标识一个可以操纵的对象。某些函数可能返回 INVALID_HANDLE_VALUE的一个句柄值，它被定义为-。函数的Platform sdk文档清楚的说明了函数是返回NULL还是 INVALID_HANDLE_VALUE来表示失败

PVOID 如果韩寒苏调用失败，则返回NULL，否则，PVOID将标识一个数据块的内存地址

LONG/DWORD 这种类型比较棘手，返回计数的函数通常会返回一个LONG或DWORD。如果函数出于某种原因不能对我们想要计数的东西进行计数，它通常会返回0或-1（具体取决于函数）。如果要调用一个返回LONG/DWORD的函数，务必仔细阅读Platfrom sdk文档，确保我们会正确地检查可能出现的错误。

Format Message函数

//拽自网上

1. DWORD WINAPI FormatMessage (
   
2.                             DWORD dwFlags, // source and processing options
   
3.                             LPCVOID lpSource, // message source
   
4.                             DWORD dwMessageId, // message identifier
   
5.                             DWORD dwLanguageId, // language identifier
   
6.                             LPTSTR lpBuffer, // message buffer
   
7.                             DWORD nSize, // maximum size of message buffer
   
8.                             va_list *Arguments // array of message inserts
   
9.                             );

dwFlags  格式化选项，对 lpSource 参数值有指导作用。
dwFlags 的低位值指定了函数如何处理输出缓冲区处理行转换，也可以指定格式化输出字符串输出行的最大宽度。

标志位，决定如何说明lpSource参数，dwFlags的低位制定如何处理换行功能在输出缓冲区，也决定最大宽度的格式化输出行。

可选参数：

标志	标志说明
FORMAT_MESSAGE_ALLOCATE_BUFFER	函数会分配一个足够大的缓冲区保存格式化消息，并且通过lpBuffer指向该 地址。
FORMAT_MESSAGE_ARGUMENT_ARRAY	Arguments参数不是指向va_list结构体，但是是一个指向保存参数的数据。
FORMAT_MESSAGE_FROM_HMODULE	lpSource参数是需要去搜索的一个包含消息表的模块线程。如果lpSource 是NULL，当前进程的应用图像会被搜索，这个标志不能同 FORMAT_ME SSAGE_FROM_STRING使用。
FORMAT_MESSAGE_FROM_STRING	lpSource参数是一个指向以NULL结尾的字符串，字符串包含一个消息定义， 这个消息定义可以包含插入序列。此标志最好不要和 FORMAT_MESSAGE _F ROM_HMODULE或者 FORMAT_MESSAGE_FROM_SYSTEM使用
FORMAT_MESSAGE_FROM_SYSTEM 0x00001000	函数会为了请求的信息而搜索系统的消息表资源。如果标志同时也指定了 FORMAT_MESSAGE_FROM_HMODULE，那么函数会先在lpSource指定 的模块中搜索请求的消息，如果搜索不到，就去搜索系统消息表资源。此 标志不能与 FORMAT_MESSAGE_FROM_STRING使用。
FORMAT_MESSAGE_IGNORE_INSERTS	消息定义中的插入序列会被一直忽略和跳过直到输出缓冲区不改变，并且 Arguments会被忽略。

如果函数调用成功，返回输出缓冲区的大小，除最后一个空字符。如果失败侧返回0。

开始在上面说了dwflags参数低位值作用，你可以使用以下值来设置低位值。

 

Value	Meaning
0	将不会有输出行宽度限制。
FORMAT_MESSAGE_MAX_WIDTH_MASK 0x000000FF

lpSource：

这个值是消息表资源来自哪里，这个值依靠dwFlags,详细请看FORMAT_MESSAGE_FROM_HMODULE和FORMAT_MESSAGE_FROM_STRING，如果这两个标示符都没设置，那么lpSource将会被忽略。

 

dwMessageId ：

所需格式化消息的标识符。当dwFlags设置了FORMAT_MESSAGE_FROM_STRING，这个参数将会被忽略。

 

dwLanguageId：

格式化消息语言标识符。

 

lpBuffer：

 一个缓冲区指针来接受格式化后的消息。当dwFlags包括了FORMAT_MESSAGE_ALLOCATE_BUFFER标志符，这个函数将会使用LocalAlloc函数分配一块缓冲区，lpBuffer需要接受一个地址来使用这个缓冲区。（这里要注意传参一定要传地址）。

 

nSize：

 如果FORMAT_MESSAGE_ALLOCATE_BUFFER没有设置，那么这个参数指定了输出缓冲区的消息，以TCHARs为单位。如果FORMAT_MESSAGE_ALLOCATE_BUFFER设置了，这个参数设置以TCHARs为单位的输出缓冲区的最小值。这个输出缓冲区不能大于64KB。

 

Arguments:

一个数组中的值在格式化消息中作为插入值，根据消息文本的格式里面的内容（详见mc.exe使用），可以知道%n[!format_specifier!]为这个参数的指定形式。

例一：

使用系统的消息资源来报错,这也是这个函数最有用的地方。

点击(此处)折叠或打开

1. #include <windows.h>
   
2. #include <strsafe.h>
   
3.   
   
4. void ErrorExit(LPTSTR lpszFunction)
   
5. {
   
6.     // Retrieve the system error message for the last-error code
   
7.   
   
8.     LPVOID lpMsgBuf;
   
9.     LPVOID lpDisplayBuf;
   
10.     DWORD dw = GetLastError();
    
11.   
    
12.     FormatMessage(
    
13.         FORMAT_MESSAGE_ALLOCATE_BUFFER |
    
14.         FORMAT_MESSAGE_FROM_SYSTEM |
    
15.         FORMAT_MESSAGE_IGNORE_INSERTS,
    
16.         NULL,
    
17.         dw,
    
18.         MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
    
19.         (LPTSTR) &lpMsgBuf,
    
20.         0, NULL );
    
21.   
    
22.     // Display the error message and exit the process
    
23.   
    
24.     lpDisplayBuf = (LPVOID)LocalAlloc(LMEM_ZEROINIT,
    
25.         (lstrlen((LPCTSTR)lpMsgBuf)+lstrlen((LPCTSTR)lpszFunction)+40)*sizeof(TCHAR));
    
26.     StringCchPrintf((LPTSTR)lpDisplayBuf,
    
27.         LocalSize(lpDisplayBuf),
    
28.         TEXT("%s failed with error %d: %s"),
    
29.         lpszFunction, dw, lpMsgBuf);
    
30.     MessageBox(NULL, (LPCTSTR)lpDisplayBuf, TEXT("Error"), MB_OK);
    
31.   
    
32.     LocalFree(lpMsgBuf);
    
33.     LocalFree(lpDisplayBuf);
    
34.     ExitProcess(dw);
    
35. }
    
36.   
    
37. void main()
    
38. {
    
39.     // Generate an error
    
40.   
    
41.     if(!GetProcessId(NULL))
    
42.         ErrorExit(TEXT("GetProcessId"));
    
43. }

我们可以看到函数选项dwFlags

分别为FORMAT_MESSAGE_ALLOCATE_BUFFER由函数分配输出缓冲区，

FORMAT_MESSAGE_FROM_SYSTEM表示程序将会在系统消息表资源中搜索所需消息，

FORMAT_MESSAGE_IGNORE_INSERTS程序将会忽略搜索到消息中的插入序列。

lpSource值为NULL,并没有模块值和字符串直接传入所以为NULL，详细看以上各参数解析。

dwMessageId为dw，即GetLastError的返回值。就是消息资源的ID号。

dwLanguageId 设置为本地默认

lpBuffer 输出缓冲区这里注意& 为什么要&呢？ 因为 LPVOID lpMsgBuf只是一个指针对象，那么要必须要把它的地址传给lpBuffer参数。

剩下两个参数可以上面参数的详解。

最后注意一点：由于lpBuffer这个参数的值是FormatMessage函数动态分配的缓冲区，所以在不使用的时候要LocalFree.

例二：

格式化模块中的消息资源，这里加载的模块之中要有消息资源，如果FormatMessage函数中传递了FORMAT_MESSAGE_FROM_SYSTEM，如果消息模块中没有我们所需的资源，那么将会在系统中寻找；如果没有 FORMAT_MESSAGE_FROM_SYSTEM，而且消息模块中没有我们所需资源，函数调用失败。

点击(此处)折叠或打开

1. #include <windows.h>
   
2. #include <stdio.h>
   
3.   
   
4. #include <lmerr.h>
   
5.   
   
6. void
   
7. DisplayErrorText(
   
8.     DWORD dwLastError
   
9.     );
   
10.   
    
11. #define RTN_OK 0
    
12. #define RTN_USAGE 1
    
13. #define RTN_ERROR 13
    
14.   
    
15. int
    
16. __cdecl
    
17. main(
    
18.     int argc,
    
19.     char *argv[]
    
20.     )
    
21. {
    
22.     if(argc != 2) {
    
23.         fprintf(stderr,"Usage: %s <error number>\n", argv[0]);
    
24.         return RTN_USAGE;
    
25.     }
    
26.   
    
27.     DisplayErrorText( atoi(argv[1]) );
    
28.   
    
29.     return RTN_OK;
    
30. }
    
31.   
    
32. void
    
33. DisplayErrorText(
    
34.     DWORD dwLastError
    
35.     )
    
36. {
    
37.     HMODULE hModule = NULL; // default to system source
    
38.     LPSTR MessageBuffer;
    
39.     DWORD dwBufferLength;
    
40.   
    
41.     DWORD dwFormatFlags = FORMAT_MESSAGE_ALLOCATE_BUFFER |
    
42.         FORMAT_MESSAGE_IGNORE_INSERTS |
    
43.         FORMAT_MESSAGE_FROM_SYSTEM ;
    
44.   
    
45.     //
    
46.     // If dwLastError is in the network range,
    
47.     // load the message source.
    
48.     //
    
49.   
    
50.     if(dwLastError >= NERR_BASE && dwLastError <= MAX_NERR) {
    
51.         hModule = LoadLibraryEx(
    
52.             TEXT("netmsg.dll"),
    
53.             NULL,
    
54.             LOAD_LIBRARY_AS_DATAFILE
    
55.             );
    
56.   
    
57.         if(hModule != NULL)
    
58.             dwFormatFlags |= FORMAT_MESSAGE_FROM_HMODULE;
    
59.     }
    
60.   
    
61.     //
    
62.     // Call FormatMessage() to allow for message
    
63.     // text to be acquired from the system
    
64.     // or from the supplied module handle.
    
65.     //
    
66.   
    
67.     if(dwBufferLength = FormatMessageA(
    
68.         dwFormatFlags,
    
69.         hModule, // module to get message from (NULL == system)
    
70.         dwLastError,
    
71.         MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT), // default language
    
72.         (LPSTR) &MessageBuffer,
    
73.         0,
    
74.         NULL
    
75.         ))
    
76.     {
    
77.         DWORD dwBytesWritten;
    
78.   
    
79.         //
    
80.         // Output message string on stderr.
    
81.         //
    
82.         WriteFile(
    
83.             GetStdHandle(STD_ERROR_HANDLE),
    
84.             MessageBuffer,
    
85.             dwBufferLength,
    
86.             &dwBytesWritten,
    
87.             NULL
    
88.             );
    
89.   
    
90.         //
    
91.         // Free the buffer allocated by the system.
    
92.         //
    
93.         LocalFree(MessageBuffer);
    
94.     }
    
95.   
    
96.     //
    
97.     // If we loaded a message source, unload it.
    
98.     //
    
99.     if(hModule != NULL)
    
100.         FreeLibrary(hModule);
     
101. }

之前两个例子都是经常使用的，那么FormatMessage之中还有个参数我们没有用过的，Arguments，那么我们在什么情况下使用呢？

 我们前面已经详细解释了各个参数详细意义。我们先来看msdn两个有关使用这个值的例子：

点击(此处)折叠或打开

1. #ifndef UNICODE
   
2. #define UNICODE
   
3. #endif
   
4.   
   
5. #include <windows.h>
   
6. #include <stdio.h>
   
7.   
   
8. void main(void)
   
9. {
   
10.     LPWSTR pMessage = L"%1!*.*s! %4 %5!*s!";
    
11.     DWORD_PTR pArgs[] = { (DWORD_PTR)4, (DWORD_PTR)2, (DWORD_PTR)L"Bill", // % refers back to the first insertion string in pMessage
    
12.          (DWORD_PTR)L"Bob", // %4 refers back to the second insertion string in pMessage
    
13.          (DWORD_PTR)6, (DWORD_PTR)L"Bill" }; // % refers back to the third insertion string in pMessage
    
14.     const DWORD size = 100+1;
    
15.     WCHAR buffer[size];
    
16.   
    
17.   
    
18.     if (!FormatMessage(FORMAT_MESSAGE_FROM_STRING | FORMAT_MESSAGE_ARGUMENT_ARRAY,
    
19.                        pMessage,
    
20.                        0,
    
21.                        0,
    
22.                        buffer,
    
23.                        size,
    
24.                        (va_list*)pArgs))
    
25.     {
    
26.         wprintf(L"Format message failed with 0x%x\n", GetLastError());
    
27.         return;
    
28.     }
    
29.   
    
30.     // Buffer contains " Bi Bob Bill".
    
31.     wprintf(L"Formatted message: %s\n", buffer);
    
32. }

根据msdn中对Arguments参数的解释，这里插入序列遵循%n[!format_specifier!]

这个格式，如果format_specifer不清楚可以查阅printf输出格式。

LPWSTR pMessage = L"%1!*.*s! %4 %5!*s!";

的意义如下：

%1!*.*s!  表示为 %1取数组第一个位置的字符串的值，

!*.*s! 就是[!format_specfier!]的内容，所以我们就想知道 *.*s含义，

根据printf输出格式我们可以知道第一个星号* 表示输出宽度，点号（.）表示下面一个星号是输出精度。

故我们可以看到数组pArgs前面3个值，4 ，2，Bill 。4为要格式的宽度，2为要格式的精度，Bill为要格式的字符串。

%4 取数组第四个值的字符串，它没有format_specifier 所以按默认输出宽度和精度。

%5!*s! 表示输出的是取数组第五个值的字符串，宽度为6。

msdn 还提供了一个使用va_list类型的例子：

点击(此处)折叠或打开

1. #ifndef UNICODE
   
2. #define UNICODE
   
3. #endif
   
4.   
   
5. #include <windows.h>
   
6. #include <stdio.h>
   
7.   
   
8. LPWSTR GetFormattedMessage(LPWSTR pMessage, );
   
9.   
   
10. void main(void)
    
11. {
    
12.     LPWSTR pBuffer = NULL;
    
13.     LPWSTR pMessage = L"%1!*.*s! %3 %4!*s!";
    
14.   
    
15.     // The variable length arguments correspond directly to the format
    
16.     // strings in pMessage.
    
17.     pBuffer = GetFormattedMessage(pMessage, 4, 2, L"Bill", L"Bob", 6, L"Bill");
    
18.     if (pBuffer)
    
19.     {
    
20.         // Buffer contains " Bi Bob Bill".
    
21.         wprintf(L"Formatted message: %s\n", pBuffer);
    
22.         LocalFree(pBuffer);
    
23.     }
    
24.     else
    
25.     {
    
26.         wprintf(L"Format message failed with 0x%x\n", GetLastError());
    
27.     }
    
28. }
    
29.   
    
30. // Formats a message string using the specified message and variable
    
31. // list of arguments.
    
32. LPWSTR GetFormattedMessage(LPWSTR pMessage, )
    
33. {
    
34.     LPWSTR pBuffer = NULL;
    
35.   
    
36.     va_list args = NULL;
    
37.     va_start(args, pMessage);
    
38.   
    
39.     FormatMessage(FORMAT_MESSAGE_FROM_STRING |
    
40.                   FORMAT_MESSAGE_ALLOCATE_BUFFER,
    
41.                   pMessage,
    
42.                   0,
    
43.                   0,
    
44.                   (LPWSTR)&pBuffer,
    
45.                   0,
    
46.                   &args);
    
47.   
    
48.     va_end(args);
    
49.   
    
50.     return pBuffer;
    
51. }

那么我们已经看完了所有的使用方法了，但是可能我们还会想Argument到底有什么用按照以上所述。

在消息资源的消息文本中我们可能会使用插入序列，让消息文本显示更加灵活。

比如我们在消息资源中的一个消息里面定义一个消息文本内容如下：

%1!*.*s! %4 %5!*s!

那么我们在调用消息模块的时候代码如下：

点击(此处)折叠或打开

1. DWORD_PTR pArgs[] = { (DWORD_PTR)4, (DWORD_PTR)2, (DWORD_PTR)L"Bill", // % refers back to the first insertion string in pMessage
   
2.              (DWORD_PTR)L"Bob", // %4 refers back to the second insertion string in pMessage
   
3.              (DWORD_PTR)6, (DWORD_PTR)L"Bill" }; // % refers back to the third insertion string in pMessage
   
4.          if (hDll != NULL) {
   
5.   
   
6.             fOk = FormatMessage(
   
7.                FORMAT_MESSAGE_FROM_HMODULE | FORMAT_MESSAGE_ARGUMENT_ARRAY |
   
8.                FORMAT_MESSAGE_ALLOCATE_BUFFER,
   
9.                hDll, dwError, systemLocale,
   
10.                (PTSTR) &hlocal, 0, (va_list*)pArgs);
    
11.             FreeLibrary(hDll);
    
12.          }
    
13.       }

原文：http://www.cppblog.com/koople/archive/2009/12/03/102367.aspx

<script>window._bd_share_config={"common":{"bdSnsKey":{},"bdText":"","bdMini":"2","bdMiniList":false,"bdPic":"","bdStyle":"0","bdSize":"16"},"share":{}};with(document)0[(getElementsByTagName('head')[0]||body).appendChild(createElement('script')).src='http://bdimg.share.baidu.com/static/api/js/share.js?v=89860593.js?cdnversion='+~(-new Date()/36e5)];</script>

阅读(177) | 评论(0) | 转发(0) |

0

上一篇：浅谈C语言中的位段

下一篇：Windows STL算法学习一 find与find_if

相关热门文章

• 利用进程信息追查内存泄漏...
• 欢迎学习三思在ChinaUnix博客...
• 欢迎老赵爱编程在ChinaUnix博...
• 欢迎扶朕起来朕要学习在ChinaU...
• 欢迎要努力学习啊在ChinaUnix...

• LNK1123: 转换到 COFF 期间失...
• WIN7访问共享:0x80070035 找不...
• Delphi 2010下载+完美破解...
• VISIO，不规则封闭图形填充方...
• vs2010调试C＋＋程序时提示 无...

给主人留下些什么吧！~~

评论热议