SNMP用VC實現的方法

首先來闡述幾個重要的概念:
     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等點分字符串。

以下我們按步驟給予詳細介紹:

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 
                                    );
    
     第一個參數是第二步返回的會話句炳,而其他兩個參數開始時就可以置爲空了。該函數返回一個綁定列表句炳。

    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()解決他們吧。

原文地址:http://www.cnblogs.com/lzjsky/archive/2012/03/02/2376568.html

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章