基於SNMP的MIB庫訪問實現兩個簡單的畫驗證碼圖形程序

SNMP(Simple Network Management Protocol)是簡單網絡管理協議,主要用來管理網絡設備，正因爲“簡單”，所以其發展很快，到目前爲止幾乎所有的網絡產品都要爲其提供支持，以方便管理員的管理和軟件開發人員的開發。

在這裏我們不對有關SNMP的概念和基礎知之作過多地闡述，一且假定你對其工作原理有了一定的瞭解，而僅缺的是如何去實現他。

我們所闡述的是基於VC6.0下的SNMP編程。詳細介紹一下有關SNMP編程的過程及API函數的用法，在遇到難於理解的部分，我會以較大的篇幅作以解釋。言歸正傳，進入我們的主題。

首先來闡述幾個重要的概念：

1、community (共同體名):如果翻譯過來可能會顯得難於理解，其實你完全可以把它理解爲一個帶有權限的登陸賬戶，這是你訪問網絡設備的重要憑據，比如你要訪問交換機，假如交換機的community是public，其權限是隻讀的，那你一次用戶登陸交換機就可以查看有關交換機記錄的數據。如果其權限是讀寫的，你你就有權修改其中的一些設置，如封鎖某一個交換機的端口。大部分交換機默認情況下，以public作爲只讀community，以private作爲讀寫community。

2、Oid(對象標誌符):是以SMI(Structure of Management Information)管理信息結構爲基礎的一系列點分符號，如1.3.6.1.2.1.1.1，這些點分符號在任何網絡設備中都唯一標識某一個數據參數。他們的集合我們稱爲MIB(Management Information Base)管理信息庫。對於他們所標識的意義，讀者可以到網上查詢一下，提供一個簡單的尋找辦法，你可以進入google，直接輸入1.3.6.1.2.1.1等點分字符串。

 

     下面進入我們的正題。

和其他編程過程一樣，整個SNMP編程也要經過一個創建，執行，銷燬的過程，通俗點說就是要做準備，初始化SNMP環境即加載SNMP的功能，接着就要執行所進行的操作，SNMP是基於消息機制的，所以消息傳遞與管理是我們在編程中所必須注意的問題，最後要進行銷燬和回收資源，這一點相信編程人員

都會注意到。以下我們按步驟給予詳細介紹：

1、加載SNMP，用到的函數是SnmpStartup(smiLPUINT32 nMajorVersion,

smiLPUINT32 nMinorVersion,
smiLPUINT32 nLevel,

smiLPUINT32 nTranslateMode,

smiLPUINT32 nRetransmitMode);
 

五個參數作爲接收參數返回SNMP的主版本號，副版本號，支持最高的操作標準，默認的實體/上下文傳輸模式，默認的重發機制。

2、建立會話，用到的函數是：

HSNMP_SESSION SnmpOpen(
HWND hWnd, // handle to the notification window

UINT wMsg // window notification message number

);
 

或

HSNMP_SESSION SnmpCreateSession(
HWND hWnd, // handle to the notification window

UINT wMsg, // window notification message number

SNMPAPI_CALLBACK pfnCallBack, // notification callback function

LPVOID lpClientData // pointer to callback function data

);
 

第二個函數並沒有被完全確定下來，他只是爲程序員在編程過程中不是基於windows的編程提供一種選擇，第一個參數指向接收消息的窗口句炳，第二個參數則指向該窗口需要接收的消息碼。該函數返回一個會話句炳，這一句炳是在我們以下程序中都要用到的一個重要變量。

3、設置傳輸模式，用到的函數是：

SNMPAPI_STATUS SnmpSetTranslateMode(
smiUINT32 nTranslateMode // new entity/context translation mode

);
 

該函數只有一個參數，有以下幾種選擇：

SNMPAPI_TRANSLATED 不常用
SNMPAPI_UNTRANSLATED_V1 版本V1

SNMPAPI_UNTRANSLATED_V2 版本V2
 

你可以選擇任一個參數，我使用過第二和第三個參數，其區別是在版本一中get_bulk的操作不被允許，因爲版本一不支持這種操作，其具體細節可查閱有關資料，推薦一本書《用SNMP管理互聯網絡》。至於第一個參數本人未作過試驗，不能加以妄斷。

4、創建實體，用到的函數是：

HSNMP_ENTITY SnmpStrToEntity(
HSNMP_SESSION session, // handle to the WinSNMP session

LPCSTR string // pointer to a string that identifies

// the entity

);
 

該函數的第一個參數是第二步返回的會話句炳，第二個參數與你在第三步中設置的傳輸模式有關，如果你選則後兩個參數，那麼這裏的string就是你要發送消息的網絡設備ip地址或接收消息的管理設備ip地址。根據自己的需要，通常我們將這兩個實體都創建一下。該函數返回一個實體句炳。

5、設置重傳模式，用到的函數是：

SNMPAPI_STATUS SnmpSetRetransmitMode(
smiUINT32 nRetransmitMode // new retransmission mode

);
 

該函數只有一個參數，有以下兩種選擇

SNMPAPI_ON 啓動重傳模式
SNMPAPI_OFF 關閉重傳模式
 

6、設置超時時間，用到的函數是：

SNMPAPI_STATUS SnmpSetTimeout(
HSNMP_ENTITY hEntity, // destination management entity

smiTIMETICKS nPolicyTimeout // new time-out value for database

);
 

該函數的第一個參數是第四步返回的實體句炳，通常我們設置目標實體的超時時間，也就是接收消息的網絡設備的實體。第二個參數是超時的時間。

7、設置重傳次數，用到的函數是：

SNMPAPI_STATUS SnmpSetRetry(
HSNMP_ENTITY hEntity, // destination management entity

smiUINT32 nPolicyRetry // new retry count value for database

);
 

該函數的第一個參數是第四步返回的實體句炳，通常我們設置目標實體的重傳次數，也就是接收消息的網絡設備的實體。第二個參數是重傳次數。

8、創建上下文句炳，用到的函數是：

HSNMP_CONTEXT SnmpStrToContext(
HSNMP_SESSION session, // handle to the WinSNMP session

smiLPCOCTETS string // pointer to a string structure

);
 

該函數的第一個參數是第二步返回的會話句炳，第二個參數與你在第三步中設置的傳輸模式有關，如果你選則後兩個參數，那麼這裏的string就是共同體名。該函數返回一個上下文句炳。

由此我們的到了三個重要的句炳，總結一下：1。會話句炳，2。實體句炳，3。上下文句炳，請記住這三個重要的句炳，因爲它們在SNMP編程過程中時刻用到，只有在結束後才釋放他們。

9、創建變量捆綁列表，用到的函數是：

HSNMP_VBL SnmpCreateVbl(
HSNMP_SESSION session, // handle to the WinSNMP session

smiLPCOID name, // pointer to the variable name

smiLPCVALUE value // pointer to the value to associate

// with the variable

);
 

這是一個比較難理解的函數，要對其有深入的理解，你必須對SNMP的數據報格式有所瞭解，在這裏我不能做過多地闡述，可以給你打個比方，好比一個專列火車，他只負責到目的地接人。開始的時候所有車廂是空的，每個車廂標有號碼，標誌其接的人的特徵，好比第一車廂要接所有姓趙的人，第二節車廂要接局以上的領導，等等。車頭由司機驅動着，他當然知道自己的目的地，一路幾經周折，終於到達目的地，此時車上還未有一個人，目的地的站長首先要檢查該司機的證件和文書，看看他有沒有權利來接走這批人，如果沒有，就會在第一個車廂內坐上一個本站的通知官，他的責任就是返回告訴源站長官說該司機沒有權力接人。如果有，那麼站長要看看各節車廂是否符合本站接人的要求，如果符合，就將不同的人送到不同的車廂就坐。如果有改姓的的請求，那麼要看本站是否允許，如果允許，就將本站這些符合條件的人改姓。

在這裏我們可以把每節車廂看作是不同變量，車廂的空間是用來接收人的，那麼具有不同特徵的人就是返回數據。這種車廂與其空間就好比一個綁定，SNMP的數據報正如這種方式一次可以有多個綁定。而車廂號就好比對象標誌符。當然只有第一個是特殊的，因爲他要有車頭，所以用SnmpCreateVbl函數，其他的綁定我們要用SnmpSetVb,將其依次連接到前一節車廂上。

好了，由上述，我們可以知道了，該函數的第一個參數是第二步返回的會話句炳，而其他兩個參數開始時就可以置爲空了。該函數返回一個綁定列表句炳。

10、追加綁定列表，用到的函數是：

SNMPAPI_STATUS SnmpSetVb(
HSNMP_VBL vbl, // handle to the variable bindings list

smiUINT32 index, // position of the variable binding entry

// in the list

smiLPCOID name, // pointer to the variable name portion

// of the entry

smiLPCVALUE value // pointer to the variable value portion

// of the entry

);
 

我們可以看到這個函數的後兩個參數與SnmpCreateVbl相同，也就是車廂與空間的綁定。第一個參數是HSNMP_VBL，一個綁定列表句炳，這也可以理解，因爲我們已經創建了綁定列表，第二個參數是變量綁定索引，想一想，這麼多節車廂，總的有個順序吧，別忙，你會提出一個顯而易見的問題，如果我只創建了頭一個綁定列表，我想在向其追加其他的綁定列表，那麼該索引值會有什麼用呢？我完全可以順序加進去啊。就像一個隊列似的。完全正確！實際上該函數也是這樣實現的，當我們要追加變量綁定時，我們須將該索引值置爲0。該索引值只是在我們實現諸如set命令時纔用到，這將在下文中敘述。

一且進行得很順利，不過如果你沒有進行過SNMP編程的話，你會對其中兩個結構感到迷惑，一個是smiLPCOID，還有就是smiLPCVALUE，別急，先看第一個結構，你會發現有一個英文組合你會很熟悉，因爲我在前文介紹過他，就是smiLPCOID中的OID，對了，他的意思是對象標誌符，LP如果你常用VC編程也會知道他多數是一個指針了。是了，他就是一個指向smiOID的指針類型。讓我們看看他的內部構造：

typedef struct {
smiUINT32 len; // number of array elements

smiLPUINT32 ptr; // pointer to an array of subidentifiers

} smiOID, *smiLPOID;
 

有兩個類型，第一個用來指定他有多少個數字，第二個則指向一個一維數組，舉個例子，如果一個對象標誌符是1.3.6.1.2.1.1.1，那麼len應該爲8，ptr應該指向一個數組，該數組的元素由1，3，6，1，2，1，1，1組成，好像“.”沒有了，正確，因爲在SNMP中就要用到這樣的結構，你會想，怎樣才能構造這樣一個結構呢？很簡單，SNMP的API函數給我們提供了方便，你可以定義一個字符串如"1.3.6.1.2.1.1.1",用

SNMPAPI_STATUS SnmpStrToOid(
LPCSTR string, // string object identifier to convert

smiLPOID dstOID // object identifier internal representation

);
 

函數來進行轉換，看看其中兩個參數，是不是很吻合的對應啊。當然，這種轉換時可逆的，你可以用SnmpOidToStr來進行，具體可以查一下MSDN。

下面講一講smiLPCVALUE，由上面的推理，你一定可以得出他是一個指向smiVALUE的指針類型。讓我們來看看smiVALUE結構，這個結構比較複雜，我試圖講得清楚一些。

typedef struct { // smiVALUE portion of VarBind
smiUINT32 syntax; // Insert SNMP_SYNTAX_<type>

union {

smiINT sNumber; // SNMP_SYNTAX_INT

// SNMP_SYNTAX_INT32

smiUINT32 uNumber; // SNMP_SYNTAX_UINT32

// SNMP_SYNTAX_CNTR32

// SNMP_SYNTAX_GAUGE32

// SNMP_SYNTAX_TIMETICKS

smiCNTR64 hNumber; // SNMP_SYNTAX_CNTR64

smiOCTETS string; // SNMP_SYNTAX_OCTETS

// SNMP_SYNTAX_BITS

// SNMP_SYNTAX_OPAQUE

// SNMP_SYNTAX_IPADDR

// SNMP_SYNTAX_NSAPADDR

smiOID oid; // SNMP_SYNTAX_OID

smiBYTE empty; // SNMP_SYNTAX_NULL

// SNMP_SYNTAX_NOSUCHOBJECT

// SNMP_SYNTAX_NOSUCHINSTANCE

// SNMP_SYNTAX_ENDOFMIBVIEW

} value; // union

} smiVALUE, *smiLPVALUE;
 

從整體上看，該結構有兩個類型構成，一個是smiUINT32 syntax; 另一個看上去挺複雜，但仔細看卻是一個共同體類型，是了，那麼它們之間有什麼聯繫呢？我們可以想象一下，一個車廂只接收一種類型的數據，該類型的數據又會有他自己的值，如此就好解釋了，syntax就是用來標誌數據類型的，當該類型確定後，我們就從union中找到與它相對應的值value。SNMP中這種設計是很巧妙的。從上面這個結構我們也就瞭解到在SNMP中所用到的基本數據類型了，也就是union中所列出的，在這提一下，通常有關網絡設備描述的值都是smiOCTETS類型。

再來看看我們已完成的工作，到目前爲止我們已經有四個句炳了，1。會話句炳，2。實體句炳，3。上下文句炳，4。綁定列表句炳。還介紹了兩個結構。這兩個結構全和變量綁定列表相關，現在火車的車廂和空間已經有了，車頭也有了，還差給他裝上輪子，找一個好司機了，需要他記住自己的使命。

11、要想將數據正確的發送到目的地，我們必須其按照特定的格式來發送，對於瞭解ip協議的編程人員來說，就不需要做過多地解釋了。我們用函數

HSNMP_PDU SnmpCreatePdu(
HSNMP_SESSION session, // handle to the WinSNMP session

smiINT PDU_type, // PDU type

smiINT32 request_id, // PDU request identifier

smiINT error_status, // valid only for SNMP_PDU_GETBULK requests

smiINT error_index, // valid only for SNMP_PDU_GETBULK requests

HSNMP_VBL varbindlist // handle to the variable bindings list

);
 

來完成該功能。

第一個和最後一個參數是我們上面構造的會話句炳和變量綁定列表句炳，第二個參數很重要，他表示我們想要執行的操作方式，SNMP中有如下的選項：

SNMP_PDU_GET
SNMP_PDU_GETNEXT

SNMP_PDU_RESPONSE

SNMP_PDU_SET

SNMP_PDU_V1TRAP

SNMP_PDU_GETBULK

SNMP_PDU_TRAP
 

對於這些操作，我建議讀者最好找點有關書籍看看，在這裏我只對部分操作大概講解一下，SNMP_PDU_GET通常用來獲得某一個特定的對象標誌符所對應的值，SNMP_PDU_GETNEXT是在編程人員不瞭解該表列情況下使用的用來獲取一組值的操作。SNMP_PDU_RESPONSE一般是SNMP代理填寫的，表示應答發出操作請求的數據報。SNMP_PDU_SET是用來改變某一對象標誌符的值的操作。SNMP_PDU_GETBULK只能在V2版本以上使用，是用來解決SNMP_PDU_GETNEXT一次消息只能取得一個數據的缺點，可通過發一次消息取得一組數據。SNMP_PDU_V1TRAP和SNMP_PDU_TRAP使用來發自陷消息的操作。

第三個參數request_id，對於同步實現消息機制的編程來說，幾乎沒有作用，但是對於異步操作，該參數有很重要的作用，你可以用它來標誌某一個請求的消息，如果有幾個消息都在消息隊列中，你可以通過它來確定自己想要處理的消息，該值完全可以自己來設定。

error_status和error_index在SNMP_PDU_GETBULK操作中分別爲PDU中non_repeaters域定一個值和PDU的max_repetitions域指定一個值。

　　在其他操作中都爲0。

　　該函數返回一個PDU句炳。

　　萬事俱備了，就讓我們的火車啓航吧。用下面的函數

12、 SNMPAPI_STATUS SnmpSendMsg(

HSNMP_SESSION session, // handle to the WinSNMP session

HSNMP_ENTITY srcEntity, // handle to the source entity

HSNMP_ENTITY dstEntity, // handle to the target entity

HSNMP_CONTEXT context, // handle to the context

HSNMP_PDU PDU // handle to the PDU

);

看看這些參數，是不是我們都已經創建過了，添上他們。

以上就是整個發送過程，我們再來理順一下，1。加載SNMP，2。建立會話，3。設置傳輸模式，4。創建實體，5。設置重傳模式，6。設置超時時間，7。設置重傳次數，8。創建上下文句炳，9。創建變量捆綁列表，10。追加綁定列表，11。創建PDU，12。發送消息。當然你如果只須獲得一個數據，那麼第10步就不需要了。

接下來我們要接收消息，並處理他們。

1、接收消息，用函數

SNMPAPI_STATUS SnmpRecvMsg(
HSNMP_SESSION session, // handle to the WinSNMP session

LPHSNMP_ENTITY srcEntity, // handle to the source entity

LPHSNMP_ENTITY dstEntity, // handle to the target entity

LPHSNMP_CONTEXT context, // handle to the context

LPHSNMP_PDU PDU // handle to the PDU

);
 

聲明一下，該函數的參數和SnmpSendMsg好像是一樣的，不錯，但參數的進出不一樣，SnmpRecvMsg除第一個參數是我們創建過的以外，其他參數都是輸出參數，就是用來接收的參數，好像很爽的樣子，因爲只需自己設定一個參數，其他的聲明一個變量，只管接收就行了。仔細想想，還挺對應的呢！

2、提取數據報，用函數

SNMPAPI_STATUS SnmpGetPduData(
HSNMP_PDU PDU, // handle to the PDU

smiLPINT PDU_type, // PDU_type field of the PDU

smiLPINT32 request_id, // request_id field of the PDU

smiLPINT error_status, // error_status field of the PDU

smiLPINT error_index, // error_index field of the PDU

LPHSNMP_VBL varbindlist // handle to the variable bindings list

);
 

也很爽，只有第一個參數是需要你輸入的，而這已經通過SnmpRecvMsg得到了，其他的參數都是需要接收的，看到什麼了，對了，request_id，如果你才用異步接收的話，它可很重要的啊，可以幫你標識發送的消息。還有error_status和error_index，記得嗎，用在SNMP_PDU_GETBULK操作中，他們的意義是不同的，除此之外，他們用來接收SNMP端返回的錯誤消息，如果返回全都是0，那就是正確返回了，如果不是，那你就的查一查他們所代表的意思了，一般的SNMP書上都會有介紹。

3、計算返回列表數目，用函數

SNMPAPI_STATUS SnmpCountVbl(
HSNMP_VBL vbl // handle to the variable bindings list

);
 

將你上一步得到的varbindlist代到裏面去就行了，他的返回只是一個整型，使你所得到的變量綁定列表返回的變量數。

4、取得返回結果，用函數

SNMPAPI_STATUS SnmpGetVb(
HSNMP_VBL vbl, // handle to the variable bindings list

smiUINT32 index, // position of the variable binding entry

// in the list

smiLPOID name, // pointer to the structure to receive the

// variable name

smiLPVALUE value // pointer to the structure to receive the

// associated value

);
 

既然在上一步已經得到了結果數，用一個簡單的for循環一次將結果取出吧。該函數有四個參數，第一個在第三步已得到，第二個就是你for循環中的變量值，記住取得變量是從0開始的，後兩個參數想想是不是與前面某個函數的參數有點相似。對了，前面我們把他們都置爲空，現在SNMP代理將返回值添了進去，我們可以坐享其成了，定義兩個變量，接收就行了。提醒一下，對ip地址的接收會有點不同，因爲返回值將其封裝爲一個指針數組了，你需要一個一個的取出來！

看上去工作是做完了，別急，還有一個很重要的環節，難道你沒想過創建了這麼多東西就不會佔用資源嗎？當然要佔用，而且你不釋放他它不會自動釋放，前面我們總共介紹了5個重要的句炳，只有會話句炳是在發送和接收消息時都用到的，所以在發送和接收消息以後，你要將其他四個句炳釋放掉，那麼會話句炳何時釋放呢？對了，應該在你應用程序退出的過程中釋放掉，進而你會想到創建會話句炳的位置了吧，那就是在構造函數裏。以上這些釋放句炳資源的函數SNMP API都有提供，如SnmpFreeEntity，SnmpFreeContext，SnmpFreeVbl，SnmpFreePdu，SnmpClose，他們的參數只有一個，就是你要是放得句炳。最後你要清理整個現場，用函數SnmpCleanup()解決他們吧。

一且到此完結，大概步驟就這些了，你也許對SNMP_PDU_SET和SNMP_PDU_TRAP有些不解，前者你可以在第10步追加綁定列表中改變變量值，當然要遵循smiVALUE的結構，將類型和值都添上，填好需要改變的對象標誌符，同時在第11步創建PDU中將類型設爲SNMP_PDU_SET就行了。

對於想進行SNMP編程的人員，在下以菜鳥的身份給你們提個醒，SNMP編成的過程很死，但精心的設計會使你的程序更加的健壯、高效和容易擴展，我強烈的建議你們看看hp的snmp++，他的源代碼很有層次，極易擴展。

 

本文來自CSDN博客，轉載請標明出處：http://blog.csdn.net/fsc2988877/archive/2007/08/15/1745387.aspx