简单SNMP管理程序的VC++代码实例实现

SNMP（Simple Network Management Protocol）是基于TCP/IP的网络管理协议，关于其工作原理网上很多，百度一下或者看看MSDN，今天在这里记一下实现的步骤，本人工作环境是Windows XP professional SP2 + Microsoft Visual Studio .net 2003，不保证其他平台与本人的步骤一致。

一、安装SNMP服务
先查看系统中是否已经安装有SNMP服务，开始->运行->cmd->回车
输入命令“net start snmp”：

C:\Documents and Settings\mmpire>net start snmp SNMP Service 服务正在启动 . SNMP Service 服务已经启动成功。 C:\Documents and Settings\mmpire>

则已经安装有SNMP，如果没有安装，则需先安装SNMP服务：

1. 打开控制面板，双击[添加/删除程序]； 2. 在弹出的[添加/删除程序]对话框的左窗格中，单击 [添加/删除 Windows 组件]； 3. 在弹出的[Windows 组件向导]中双击 [管理和监视工具]。 4. 在弹出的[管理和监视工具] 对话框中，勾选[简单网络管理协议]，单击 [确定]。 5. 安装协议时需要用到Windows XP SP2安装盘，之后可能需要重启，不过我的机器没要求:P

再按前面的执行“net start snmp”命令启动SNMP服务。
******************************************************************
二、代码示例
这种编程一般都有套路，即需要遵循一定的格式，MS提供了SNMP编程的样例代码，这个样例是一个最简单的Snmp管理程序，用户通过输入Snmp命令来进行交互。我们可以从中查看WinSNMP的API的使用方法。所有样例代码都在Platform SDK中，可以在下面的地址下载到最新版的Platform SDK：
http://www.microsoft.com/downloads/details.aspx?FamilyId=484269E2-3B89-47E3-8EB7-1F2BE6D7123A&displaylang=en
可以看看它的介绍（哈，几乎支持了所有现在的Windows版本），只要下载全部17个PSDK-FULL.*.cab及最后一个PSDK-FULL.exe，之后全部解压缩并安装到某个文件夹中即可。
1. 找到示例代码
进入platformsdk\Samples\NetDS\Snmp，可以看到三个文件夹：SnmpUtil，TestDll，Wsnmp以及一个Makefile。其中SnmpUtil与TestDll是基于NT平台的，略去不说，具体参看内附的readme。而Makefile是用来编译所有这三个文件里的模块的，对于XP平台前两个文件夹里的模块不能正确编译，所以也不看。进入Wsnmp文件夹，我们需要的示例代码就在这里。将五个文件全拷贝到D盘根目录。
2. 编译示例代码
从以下路径打开VC.net命令行窗口：
开始->所有程序-> Visual Studio .NET 2003->Visual Studio .NET 2003 命令提示
VC6下的路径差不多，自己找一下。打开窗口之后输入以下命令：

C:\Documents and Settings\mmpire>d: D:\>nmake all Microsoft (R) 程序维护实用工具 7.10.3077 版 版权所有 (C) Microsoft Corporation。保留所有权利。 if not exist "WIN2000_DEBUG/" mkdir WIN2000_DEBUG cl -Zi -Od -DDEBUG -c -DCRTAPI1=_cdecl -DCRTAPI2=_cdecl -nologo -D_X86_=1-DWIN32 -D_WIN32 -W3 -D_WINNT -D_WIN32_WINNT=0x0500 -D_WIN32_IE=0x0500 –DWINV ER=0x0500 -D_MT -MTd /Fo"WIN2000_DEBUG\\" /Fd"WIN2000_DEBUG\\" wsnmputil.cpp wsnmputil.cpp cl -Zi -Od -DDEBUG -c -DCRTAPI1=_cdecl -DCRTAPI2=_cdecl -nologo -D_X86_=1 -DWIN32 -D_WIN32 -W3 -D_WINNT -D_WIN32_WINNT=0x0500 -D_WIN32_IE=0x0500 –DWINV ER=0x0500 -D_MT -MTd /Fo"WIN2000_DEBUG\\" /Fd"WIN2000_DEBUG\\" helper.cpp helper.cpp link /DEBUG:full /DEBUGTYPE:cv /INCREMENTAL:NO /NOLOGO -subsystem:conso le,5.0 kernel32.lib ws2_32.lib mswsock.lib advapi32.lib -out:WIN2000_DEBUG\wsnm putil.exe WIN2000_DEBUG\wsnmputil.obj WIN2000_DEBUG\helper.obj user32.lib gdi32.lib snmpapi.lib wsnmp32.lib mgmtapi.lib oldnames.lib D:\>

可以发现当前目录下出现一个子目录WIN2000_DEBUG，也可以用nmake删除：

D:\>nmake clean Microsoft (R) 程序维护实用工具 7.10.3077 版 版权所有 (C) Microsoft Corporation。保留所有权利。 if exist WIN2000_DEBUG/ rd /s /q WIN2000_DEBUG D:\>

当然现在我们还需要它，根据其readme文件所述，这个示例代码是一个SNMP管理程序（SNMP Manager Application），展示了如何使用WinSNMP的API编写应用程序。它支持SNMP 1的Get，GetNext，Set操作，以及SNMP2的GetBulk操作。而扩展的Walk和Subtree操作则使用GetNext操作来实现。
3. 测试示例
①监听SNMP的端口

D:\>cd WIN2000_DEBUG D:\WIN2000_DEBUG>wsnmputil trap WSnmpUtil: listening for traps...

②另外打开一个VC.net命令行窗口

D:\WIN2000_DEBUG>net stop snmp SNMP Service 服务正在停止.. SNMP Service 服务已成功停止。 D:\WIN2000_DEBUG>net start snmp SNMP Service 服务正在启动 . SNMP Service 服务已经启动成功。 D:\WIN2000_DEBUG>

③按照其readme里所描述的，在第一个监听窗口会出现以下信息

D:\WIN2000_DEBUG>wsnmputil trap WSnmpUtil: listening for traps... Agent : 127.0.0.1 OID :1.3.6.1.2.1.1.3.0 OID string: system.sysUpTime.0 TIMETICKS: 0 (注:…太长…略去)

可惜在本人机器上，第一个窗口始终没有反应，似乎SNMP服务启动时会向局域网发送SNMP的数据包，但我不确定，以后解决了再写。
④再测试几个命令

D:\WIN2000_DEBUG>wsnmputil usage: wsnmputil [-v1|-v2] [get|getnext|walk|getbulk|subtree] agent community [ non_repeaters max_repetitions] oid [oid ...] Examples: wsnmputil trap wsnmputil -v1 get localhost public 1.3.6.1.2.1.1.1.0 wsnmputil -v1 getnext localhost public 1.3.6.1.2.1.1.1.0 wsnmputil -v1 subtree localhost public 1.3.6.1.2.1.1 wsnmputil -v1 set toaster public 1.3.6.1.4.1.12.2.5.0 2 wsnmputil -v2 walk localhost public 1 wsnmputil -v2 getbulk toaster public 1 2 1.3.6.1.2.1.1.2.0 1.3.6.1.2.1.4.2 2.1.2 1.3.6.1.2.1.4.22.1.4 D:\WIN2000_DEBUG>wsnmputil -v2 walk localhost public 1 (注:….非常多的结果…不过现在还不知道什么意思…汗) D:\WIN2000_DEBUG>wsnmputil -v1 get localhost public 1 OID :1.3.6.1.2.1.1 system NULL – NULL D:\WIN2000_DEBUG>wsnmputil -v1 getnext localhost public 1.3.6.1.2.1.1.1.0 (注: 1.3.6.1.2.1.1.1.0是在OidView里看到的，貌似是本人agent的地址) OID :1.3.6.1.2.1.1.2.0 system.sysObjectID.0 OBJECT IDENTIFIER - .1.3.6.1.4.1.311.1.1.3.1.1

******************************************************************
[align=left]三、代码分析[/align]
[align=left]一共三个文件：WSnmpUtil.h WSnmpUtil.Cpp Helper.Cpp
具体代码在后面贴出，这里分析一下其大体结构：
1. WSnmpUtil.h
21个常量定义，一个结构体类型声明，一个GlobalVars类声明，以及19个函数声明。
[/align]
2. Helper.Cpp
一些函数定义，比如输出提示消息，解析命令行输入的命令，调试信息，地址转换，输出Oid地址以及pSession的参数。
3. WSnmpUtil.Cpp
[align=left]程序骨干如下：
＃i nclude <stdio.h>[/align]
[align=left]＃i nclude <string.h>[/align]
[align=left]＃i nclude <stdlib.h>[/align]
[align=left]＃i nclude <winsock2.h>[/align]
[align=left]＃i nclude <winsnmp.h>[/align]
[align=left]＃i nclude <snmp.h>[/align]
[align=left]＃i nclude <mgmtapi.h>[/align]
[align=left]＃i nclude "WSnmpUtil.h"
//外部全局变量gVars，记录用户命令等信息[/align]
[align=left]GlobalVars gVars; [/align]
[align=left]int main( int argc, char **argv )[/align]
[align=left]{ //初试化一般参数[/align]
[align=left] PSNMP_MGR_SESSION pSession = NULL;[/align]
[align=left] int nReturn = 0;[/align]
[align=left] BOOL result;[/align]
[align=left] int i = 0;[/align]
[align=left] //初试化SNMP参数[/align]
[align=left] smiUINT32 nMajorVersion = 0;[/align]
[align=left] smiUINT32 nMinorVersion = 0;[/align]
[align=left] smiUINT32 nLevel = 0;[/align]
[align=left] smiUINT32 nTranslateMode = 0;[/align]
[align=left] smiUINT32 nRetransmitMode = 0;[/align]
[align=left] [/align]
[align=left]//接收用户在命令行输入的命令，主要记录在变量gVars中[/align]
[align=left]ParseCommandLine( argc, argv );[/align]
[align=left] [/align]
[align=left]//加载SNMP服务[/align]
[align=left]SnmpStartup(&nMajorVersion,&nMinorVersion,&nLevel,&nTranslateMode,&nRetransmitMode);[/align]
[align=left] [/align]
[align=left]//分两种情况设置传输模式(SNMP1/SNMP2)[/align]
[align=left] if ( gVars.version == FALSE )[/align]
[align=left] SnmpSetTranslateMode( SNMPAPI_UNTRANSLATED_V1 );[/align]
[align=left] else[/align]
[align=left] SnmpSetTranslateMode( SNMPAPI_UNTRANSLATED_V2 );[/align]
[align=left] [/align]
[align=left]//为会话分配内存空间[/align]
[align=left] pSession = ( PSNMP_MGR_SESSION )SnmpUtilMemAlloc( sizeof( SNMP_MGR_SESSION ) );[/align]
[align=left] [/align]
[align=left]/*创建一个隐藏的负责监听WinSNMP消息的窗口，这是一段典型的调用CreateWindow()创建windows窗口的代码。（注:窗口处理函数是NotificationWndProc()，本程序调用CreatWindow()后返回，而由系统来创建窗口，其中就要调用这个窗口处理函数，这种由程序员编写而由系统调用的函数需要定义为CALLBACK函数）注意：SNMP接收的数据包(PDU)就在窗口进程里处理*/[/align]
[align=left] CreateNotificationWindow( pSession );[/align]
[align=left] [/align]
[align=left]//建立会话[/align]
[align=left] SnmpOpen( pSession->hWnd, WM_SNMP_INCOMING );
[/align]
[align=left][/align]
[align=left] [/align]
[align=left]//解析用户在命令行输入的命令[/align]
[align=left] switch (gVars.operation)[/align]
[align=left] {[/align]
[align=left] case TRAP:WaitForTraps( pSession );break;[/align]
[align=left] case WALK:CreatePduSendRequest( pSession, NULL );break;[/align]
[align=left] case GET:[/align]
[align=left] case GET_NEXT:result = CreatePduSendRequest( pSession, NULL ); break;[/align]
[align=left]//创建一个PDU并发送一个请求 [/align]
[align=left] case GET_BULK:result = CreatePduSendRequest( pSession, NULL ); break;[/align]
[align=left] case SUB_TREE:result = CreatePduSendRequest( pSession, NULL ); break;[/align]
[align=left]case SET:result = CreatePduSendRequest( pSession, NULL );break; [/align]
[align=left]//先探测所给agent是否存在，之后再发送设定消息[/align]
[align=left] }[/align]
[align=left] [/align]
[align=left] CloseWinSNMPSession ( pSession );//关闭WinSNMP任务，调用了SnmpClose()[/align]
[align=left] SnmpUtilMemFree( pSession );//释放内存[/align]
[align=left] SnmpCleanup( );//清理工作[/align]
[align=left] WSACleanup( );//关闭windows sockets[/align]
[align=left] return ( nReturn );[/align]
} //end of main()

四、其他说明
1. 用VC编译
方法一：
建立工程并添加上述三个文件，这时可以编译通过，但链接是会出现许多错误，大多是“未能解析的符号”，这时我们还需要给工程添加一些库，操作路径如下：
项目->属性->链接器->命令行
在“附加选项”中加入
"user32.lib gdi32.lib snmpapi.lib wsnmp32.lib mgmtapi.lib oldnames.lib Ws2_32.lib"
前面的lib库摘自其makefile，最后一个Ws2_32.lib是google出来的:P

方法二：
打开VC.net，按以下操作路径：
文件->新建->项目->VC++项目->常规->生成文件项目->起个名字->确定->应用程序设置->在生成命令行里输入nmake->完成
然后把那三个文件及makefile拷贝到这个项目的目录下面，就可以编译了：
生成->生成解决方案

方法三：
前面说过了，打开VC的命令行窗口直接用nmake命令:P
2. 未解决的问题
还有很多，希望大侠们指教，蔽人邮箱mmpire@hit.edu.cn
补充：
在VC6.0环境下的编译方法：
用nmake没成功，不知道什么原因，错误是：
makefile<11> fatal error U1083: target macro '' expands to nothing
不过可以直接用VC编译，步骤如下：
a.新建一个空的控制台工程；
b.添加WSnmpUtil.h WSnmpUtil.Cpp Helper.Cpp三个文件；
c.工程->设置->link->对象/库模块；
d.加入user32.lib gdi32.lib snmpapi.lib wsnmp32.lib mgmtapi.lib oldnames.lib
Ws2_32.lib；
e.去掉SetWindowLongPtr()和GetWindowLongPtr()的Ptr后缀，然后编译。

Windows为了向64位平台转换，在某些API函数后面加上Ptr，参看winuser.h里的定义：
#ifdef _WIN64
LONG_PTR SetWindowLongPtr(
HWND hWnd,
int nIndex,
LONG_PTR dwNewLong
);
#else
#define SetWindowLongPtr SetWindowLong
#endif