計算機軟件與應用NetBIOS

計算機軟件與應用NetBIOSSUP-4NetBIOS網(wǎng)絡編程技術課程描述NetBIOS（NETworkBasicInput/OutputSystem，網(wǎng)絡基本輸入/輸出系統(tǒng)）定義了一種軟件接口以及在應用程序和連接介質(zhì)之間提供通信接口的標準方法。它可以提供名字服務、會話服務和數(shù)據(jù)庫服務，基于NetBIOS的比較典型的應用是獲取遠程計算機的Mac地址、名稱和所在工作組等信息。本章將對NetBIOS網(wǎng)絡編程技術進行介紹。本章知識點SUP-4.1NetBIOS協(xié)議及應用SUP-4.2NetBIOS開發(fā)接口SUP-4.3在程序中實現(xiàn)NBTSTAT命令的功能SUP-4.1NetBIOS協(xié)議及應用SUP-4.1.1NetBIOS協(xié)議SUP-4.1.2使用NBTSTAT命令SUP-4.1.1NetBIOS協(xié)議NetBIOS協(xié)議最初由IBM開發(fā)，微軟公司在此基礎上對該協(xié)議進行了完善，并在Windows上提供了對NetBIOS協(xié)議的支持。網(wǎng)絡鄰居功能就是基于NetBIOS協(xié)議的。在Windows中安裝TCP/IP協(xié)議的同時就會安裝NetBIOS協(xié)議。下面介紹一下在Windows2003中啟用和配置NetBIOS協(xié)議的方法。

配置NetBIOS右鍵單擊桌面上的網(wǎng)絡鄰居圖標，在彈出菜單中選擇“屬性”，打開“網(wǎng)絡連接”窗口。右鍵單擊“本地連接”圖標，在彈出菜單中選擇“屬性”，打開“本地連接屬性”對話框。

配置NetBIOS選中“Internet協(xié)議（TCP/IP）”項，單擊“屬性”按鈕，打開“Internet協(xié)議（TCP/IP）”屬性對話框。單擊“高級”按鈕，打開“高級TCP/IP設置”對話框。單擊“WINS”選項卡，可以對NetBIOS協(xié)議進行設置。1．LANA編號LANA（LANAdapter，LAN適配器）編號是NetBIOS進行網(wǎng)絡編程的關鍵，它對應于網(wǎng)卡及傳輸協(xié)議的唯一組合。例如，假定某個工作站安裝了兩塊網(wǎng)卡，以及兩種具有NetBIOS能力的傳輸協(xié)議（例如TCP/IP和NetBEUI），那么將共有下面4個LANA編號：表示“TCP/IP—網(wǎng)卡1”對。表示“NetBEUI—網(wǎng)卡1”對。表示“TCP/IP—網(wǎng)卡2”對。表示“NetBEUI—網(wǎng)卡2”對。2．名字服務NetBIOS協(xié)議支持建立名字服務器，負責查找目標主機對應的IP地址，并賦予一個NetBIOS名稱。名字服務提供的主要功能如下：添加名字，即注冊一個NetBIOS名字。添加組名，即注冊一個NetBIOS組名。刪除名字，即取消一個NetBIOS名字和組名的注冊。查詢名字，即在網(wǎng)絡中搜索NetBIOS名字。3．會話服務會話服務提供的主要功能如下：調(diào)用，即打開一個到遠程NetBIOS名字的會話。偵聽，即偵聽其他程序的連接請求。掛起，即關閉一個會話。發(fā)送，即向會話對端的計算機發(fā)送一個數(shù)據(jù)包，并等待對方確認。無確認發(fā)送，即向會話對端的計算機發(fā)送一個數(shù)據(jù)包，但不需要對方確認。接收，即等待從會話對端發(fā)送的數(shù)據(jù)包到達。4．數(shù)據(jù)報服務數(shù)據(jù)報服務提供的主要功能如下：發(fā)送數(shù)據(jù)報，即向遠程NetBIOS名字發(fā)送一個數(shù)據(jù)報。發(fā)送廣播數(shù)據(jù)報，即向網(wǎng)絡中所有NetBIOS名字發(fā)送數(shù)據(jù)報。接收數(shù)據(jù)報，即等待從發(fā)送數(shù)據(jù)報操作中到達的數(shù)據(jù)。接收廣播數(shù)據(jù)報，即等待從發(fā)送廣播數(shù)據(jù)報操作中到達的數(shù)據(jù)。在Windows中，如果安裝了NetBIOS協(xié)議，則系統(tǒng)將自動開放下列端口：137端口，主要作用是在局域網(wǎng)中提供計算機的名稱或IP地址查詢服務。138端口，主要作用是提供NetBIOS環(huán)境下的計算機名瀏覽功能。139端口，主要作用是提供文件和打印機共享的功能。SUP-4.1.2使用NBTSTAT命令在Windows命令窗口中執(zhí)行NBTSTAT命令，可以獲取指定遠程計算機的基本信息，包括Mac地址、計算機名和所屬工作組等。NBTSTAT命令的格式如下：

NBTSTAT[[-aRemoteName][-AIPaddress][-c][-n][-r][-R][-RR][-s][-S][interval]]NBTSTAT參數(shù)的具體說明參

數(shù)說

明-aRemoteName列出指定名稱的遠程機器的名稱表，RemoteName表示指定的遠程主機計算機名-AIPaddress列出指定

IP地址的遠程機器的名稱表，IPaddress表示用點分法表示的IP地址-c列出遠程計算機名稱及其IP地址的

NBT緩存-n列出本地的NetBIOS名稱-r列出通過廣播和經(jīng)由WINS解析的名稱-R清除和重新加載遠程緩存名稱表-RR將名稱釋放包發(fā)送到WINS，然后啟動刷新-s列出將目標IP地址轉(zhuǎn)換成計算機NetBIOS名稱的會話表-S列出具有目標IP地址的會話表interval重新顯示選定的統(tǒng)計、每次顯示之間暫停的間隔秒數(shù)。按Ctrl+C停止重新顯示統(tǒng)計實例NBTSTAT-aLEE-THINKPADSUP-4.2NetBIOS開發(fā)接口SUP-4.2.1NetBIOS操作SUP-4.2.2NCB結(jié)構(gòu)體SUP-4.2.3其他常用NetBIOS結(jié)構(gòu)體SUP-4.2.4Netbios()函數(shù)SUP-4.2.5獲取LANA上的所有NetBIOS名字SUP-4.2.6獲取網(wǎng)絡適配器上的MAC地址SUP-4.2.1NetBIOS操作協(xié)議驅(qū)動程序?qū)ν夤糔etBIOS接口，并將NetBIOS命令映射到協(xié)議驅(qū)動程序的內(nèi)部命令。NetBIOS模擬器接收NetBIOS命令，將它們轉(zhuǎn)換成TDI（TransportDriverInterface，傳輸驅(qū)動程序接口）調(diào)用，然后使用TDI接口將它們轉(zhuǎn)發(fā)到傳輸驅(qū)動程序。在Windows2003、WindowsXP、Windows2000和WindowsNT操作系統(tǒng)中，NetBIOS操作的流程如下：SUP-4.2.2NCB結(jié)構(gòu)體typedefstruct_NCB{UCHARncb_command;UCHARncb_retcode;UCHARncb_lsn;UCHARncb_num;PUCHARncb_buffer;WORDncb_length;UCHARncb_callname[NCBNAMSZ];UCHARncb_name[NCBNAMSZ];UCHARncb_rto;UCHARncb_sto;void(CALLBACK*ncb_post)(structNCB);UCHARncb_lana_num;UCHARncb_cmd_cplt;UCHARncb_reserve[X];HANDLEncb_event;}NCB,*PNCB;1．ncb_command命令編碼可選值說

明NCBACTION非標準NetBIOS3.0命令NCBADDGRNAME向本地名字表中添加一個組名，組名在網(wǎng)絡中必須是唯一的NCBADDNAME向本地名字表中添加一個唯一的名字NCBASTAT獲取本地或遠程網(wǎng)絡適配器的狀態(tài)。如果指定了此編碼，則成員變量_buffer指向填充了ADAPTER_STATUS結(jié)構(gòu)體和NAME_BUFFER結(jié)構(gòu)體數(shù)組的緩沖區(qū)NCBCALL打開與其他名字之間的會話NCBCANCEL取消之前掛起的命令NCBCHAINSEND向指定的會話伙伴發(fā)送兩個數(shù)據(jù)緩沖區(qū)的內(nèi)容NCBCHAINSENDNA向指定的會話伙伴發(fā)送兩個數(shù)據(jù)緩沖區(qū)的內(nèi)容，并且不等待對方確認NCBDELNAME從本地名字表中刪除一個名字NCBDGRECV獲取來自任意名字的數(shù)據(jù)包NCBDGRECVBC獲取來自任意名字的廣播數(shù)據(jù)包NCBDGSEND向指定名字發(fā)送數(shù)據(jù)包NCBDGSENDBC向局域網(wǎng)中的所有計算機發(fā)送廣播數(shù)據(jù)包NCBENUM用于枚舉LANA編號。如果指定此編碼，則成員變量ncb_buffer指定填充了LANA_ENUM結(jié)構(gòu)體的緩沖區(qū)。NCBENUM不是標準的NetBIOS3.0命令NCBFINDNAME決定指定名字在網(wǎng)絡中的位置。如果指定此編碼，則成員變量_buffer指定填充了FIND_NAME_HEADER結(jié)構(gòu)體和FIND_NAME_BUFFER結(jié)構(gòu)體的緩沖區(qū)NCBHANGUP關閉指定的會話NCBLANSTALERT只對WindowsServer2003、WindowsXP、Windows2000和WindowsNT等操作系統(tǒng)有效，提示用戶持續(xù)時間在1分鐘以上的局域網(wǎng)故障NCBLISTEN允許一個會話可以被其他名字打開NCBRECV從指定的會話伙伴獲取數(shù)據(jù)NCBRECVANY從指定名字對應的會話中獲取數(shù)據(jù)NCBRESET復位局域網(wǎng)網(wǎng)絡適配器NCBSEND向指定的會話伙伴發(fā)送數(shù)據(jù)NCBSENDNA向指定的會話伙伴發(fā)送數(shù)據(jù)，并且不等待對方確認NCBSSTAT獲取會話的狀態(tài)。如果指定了此參數(shù)，則成員變量_buffer指向填充了SESSION_HEADER和SESSION_BUFFER結(jié)構(gòu)體的緩沖區(qū)NCBTRACE激活或取消NCB跟蹤。此命令目前不被支持NCBUNLINK斷開一個網(wǎng)絡適配器的連接。此命令只為與之前版本的NetBIOS兼容而提供，但在Windows中無效2．ncb_retcode返回編碼可選值說

明NRC_GOODRET操作成功NRC_BUFLEN提供了無效的緩沖區(qū)長度NRC_ILLCMD提供了無效的命令NRC_CMDTMO命令超時NRC_INCOMP消息不完整，應用程序正在執(zhí)行其他命令NRC_BADDR緩沖區(qū)地址無效NRC_SNUMOUT會話編號越界NRC_NORES沒有有效的資源NRC_SCLOSED會話已被關閉NRC_CMDCAN命令被取消NRC_DUPNAME在本地名字表中存在相同的名字NRC_NAMTFUL名字表已滿NRC_ACTSES命令已執(zhí)行完成，指定名字擁有活動的會話，并且不再注冊NRC_LOCTFUL本地會話表已滿NRC_REMTFUL遠端會話表已滿，打開會話的請求被拒絕NRC_ILLNN指定了無效的名稱編號NRC_NOCALL系統(tǒng)沒有發(fā)現(xiàn)調(diào)用的名字NRC_NOWILD成員變量ncb_name中不允許通配符NRC_INUSE名字已經(jīng)在遠程適配器上使用NRC_NAMERR名字已被刪除NRC_SABORT會話非正常結(jié)束NRC_NAMCONF檢測到名字沖突NRC_IFBUSY接口忙NRC_TOOMANY命令太多，應用程序?qū)⒃谏院笾卦嚸頝RC_BRIDGE成員變量ncb_lana_num沒有指定有效的網(wǎng)絡編號NRC_CANOCCR執(zhí)行取消操作后，命令已經(jīng)結(jié)束NRC_CANCELNCBCANCEL命令無效，命令并未取消NRC_DUPENV名字已經(jīng)被另一個本地進程占用NRC_ENVNOTDEF環(huán)境沒有被定義，因此必須執(zhí)行一個重置命令NRC_OSRESNOTAV操作系統(tǒng)資源被耗光，該命令稍候會重試NRC_MAXAPPS應用程序數(shù)量超過規(guī)定的最大值NRC_NOSAPS沒有對NetBIOS有效的服務訪問點（SAP，ServiceAccesPoints）NRC_NORESOURCES請求的資源無效NRC_INVADDRESSNCB地址無效NRC_INVDDIDNCBDDID無效NRC_LOCKFAIL嘗試鎖定用戶區(qū)域失敗NRC_OPENERR當設備驅(qū)動器執(zhí)行打開操作時發(fā)生錯誤。錯誤編碼并不在NetBIOS3.0中定義NRC_SYSTEM發(fā)生系統(tǒng)錯誤NRC_PENDING異步操作并未結(jié)束NCB結(jié)構(gòu)體其他成員變量3．ncb_lsn表示本地會話編號。在指定環(huán)境中此編號唯一標識一個會話。調(diào)用Netbios()函數(shù)成功執(zhí)行了NCBCALL命令后返回此編號。4．ncb_num指定本地網(wǎng)絡名字編號。調(diào)用Netbios()函數(shù)成功執(zhí)行了NCBADDNAME或者NCBADDGRNAME命令后返回此編號。此編號在所有數(shù)據(jù)包命令和NCBRECVANY命令中使用。5．ncb_buffer指向消息緩沖區(qū)?？梢允褂帽碇械拿钤L問消息緩沖區(qū)。命

令說

明NCBSEND發(fā)送消息NCBRECV接收消息NCBSSTAT接收請求狀態(tài)信息NCB結(jié)構(gòu)體其他成員變量6．ncb_length指定消息緩沖區(qū)的大小，單位為字節(jié)。對于接收命令，此成員變量由Netbios()函數(shù)設置，表示接收到的字節(jié)數(shù)。如果緩沖區(qū)長度不正確，則Netbios()函數(shù)返回NRC_BUFLEN錯誤編碼。指定遠端應用程序的名字。8．ncb_name指定應用程序可以識別的名字。9．ncb_rto指定會話執(zhí)行接收操作的超時時間。將此成員變量指定為0，表示在執(zhí)行NCBCALL和NCBLISTEN命令時沒有超時。超時會影響隨后執(zhí)行的NCBRECV命令。10．ncb_sto指定會話執(zhí)行發(fā)送操作的超時時間。將此成員變量指定為0，表示在執(zhí)行NCBCALL和NCBLISTEN命令時沒有超時。超時會影響隨后執(zhí)行的NCBSEND和NCBCHAINSEND命令。11．ncb_post指定異步命令完成后需調(diào)用的例程地址。12．ncb_lana_num指定LANA編號。13．ncb_cmd_cplt指定命令完成標識。14．ncb_reserve保留字段，必須為0。15．ncb_event指定事件對象的句柄。當執(zhí)行異步命令時，事件對象被設置為未受信狀態(tài)；當異步命令完成后，事件對象被設置為受信狀態(tài)，這樣就可以執(zhí)行對應的事件處理程序了。SUP-4.2.3其他常用NetBIOS結(jié)構(gòu)體1．LANA_ENUM結(jié)構(gòu)體2．ADAPTER_STATUS結(jié)構(gòu)體3．NAME_BUFFER結(jié)構(gòu)體4．ASTAT結(jié)構(gòu)體1．LANA_ENUM結(jié)構(gòu)體LANA_ENUM結(jié)構(gòu)體中包含當前邏輯網(wǎng)絡適配器的數(shù)量。當一個物理網(wǎng)絡適配器綁定到一個網(wǎng)絡協(xié)議時，就對應一個邏輯網(wǎng)絡適配器。執(zhí)行NCB命令NCBENUM可以向LANA_ENUM結(jié)構(gòu)體中填充邏輯網(wǎng)絡適配器的個數(shù)和邏輯網(wǎng)絡適配器編號，此時NCB結(jié)構(gòu)體中的ncb_buffer成員變量指向LANA_ENUM結(jié)構(gòu)體。LANA_ENUM結(jié)構(gòu)體的定義代碼如下：

typedefstruct_LANA_ENUM{UCHARlength;UCHARlana[MAX_LANA];}LANA_ENUM,*PLANA_ENUM;

參數(shù)說明如下：length，系統(tǒng)中包含的邏輯網(wǎng)絡適配器數(shù)量。lana[MAX_LANA]，系統(tǒng)中包含的邏輯網(wǎng)絡適配器編號數(shù)組。2．ADAPTER_STATUS結(jié)構(gòu)體ADAPTER_STATUS結(jié)構(gòu)體中包含網(wǎng)絡適配器的信息。NCB結(jié)構(gòu)體的ncb_buffer成員變量指定該結(jié)構(gòu)體。通常，ADAPTER_STATUS結(jié)構(gòu)體的后面跟著很多NAME_BUFFER結(jié)構(gòu)體。ADPATER_STATUS結(jié)構(gòu)體的定義代碼如下：

typedefstruct_ADAPTER_STATUS{UCHARadapter_address[6];UCHARrev_major;UCHARreserved0;UCHARadapter_type;UCHARrev_minor;WORDduration;WORDfrmr_recv;WORDfrmr_xmit;WORDiframe_recv_err;WORDxmit_aborts;DWORDxmit_success;DWORDrecv_success;

WORDiframe_xmit_err;WORDrecv_buff_unavail;WORDt1_timeouts;WORDti_timeouts;DWORDreserved1;WORDfree_ncbs;WORDmax_cfg_ncbs;WORDmax_ncbs;WORDxmit_buf_unavail;WORDmax_dgram_size;WORDpending_sess;WORDmax_cfg_sess;WORDmax_sess;WORDmax_sess_pkt_size;WORDname_count;}ADAPTER_STATUS,*PADAPTER_STATUS;

ADAPTER_STATUS結(jié)構(gòu)體參數(shù)說明adapter_address，指定網(wǎng)絡適配器的地址。rev_major，指定發(fā)布軟件的主版本號。例如，如果發(fā)布版本號為，則rev_major的值為3。reserved0，保留字段，始終為0。adapter_type，指定網(wǎng)絡適配器的類型。如果是令牌環(huán)適配器，則該值為0xFF；如果是以太網(wǎng)適配器，則該值為0xFE。rev_minor，指定發(fā)布軟件的副版本號。例如，如果發(fā)布版本號為，則rev_minor的值為0。duration，指定報告的時間周期，單位為分鐘。frmr_recv，指定接收到的FRMR（幀拒絕）幀數(shù)量。frmr_xmit，指定傳送的FRMR幀數(shù)量。iframe_recv_err，指定接收到的錯誤幀數(shù)量。xmit_aborts，指定終止傳輸?shù)陌鼣?shù)量。xmit_success，指定成功傳輸?shù)陌鼣?shù)量。recv_success，指定成功接收的包數(shù)量。iframe_xmit_err，指定傳輸?shù)腻e誤幀數(shù)量。recv_buff_unavail，指定緩沖區(qū)無法為遠程計算機提供服務的次數(shù)。t1_timeouts，指定DLC（DataLinkControl，數(shù)據(jù)鏈路控制）T1計時器超時的次數(shù)。ti_timeouts，指定ti非活動計時器超時的次數(shù)。t1計時器用于檢測斷開的連接。reserved1，保留字段，始終為0。free_ncbs，指定當前空閑的網(wǎng)絡控制塊的數(shù)量。max_dgram_size，指定數(shù)據(jù)包的最大大小，該值至少為512字節(jié)。pendingsess，指定掛起會話的數(shù)量。max_cfg_sess，指定配置的最大掛起會話數(shù)量。max_sess_pkt_size，指定會話數(shù)據(jù)包的最大大小。name_count，指定本地名字表中名字的數(shù)量。3．NAME_BUFFER結(jié)構(gòu)體結(jié)構(gòu)體NAME_BUFFER中包含本地網(wǎng)絡名字信息。當應用程序執(zhí)行NCBASTAT命令時，可以獲取ADAPTER_STATUS結(jié)構(gòu)體及其后面的NAME_BUFFER結(jié)構(gòu)體。NAME_BUFFER結(jié)構(gòu)體。typedefstruct_NAME_BUFFER{UCHARname[NCBNAMSZ];UCHARname_num;UCHARname_flags;}NAME_BUFFER,*PNAME_BUFFER;參數(shù)說明如下：name，指定本地網(wǎng)絡名字，該值對應NCB結(jié)構(gòu)體的ncb_name字段。name_num，指定本地網(wǎng)絡名字的數(shù)量，該值對應NCB結(jié)構(gòu)體的ncb_num字段。name_flags，指定名字表條目的當前狀態(tài)。4．ASTAT結(jié)構(gòu)體ASTAT結(jié)構(gòu)體用于描述網(wǎng)絡適配器的狀態(tài)和名字信息，定義代碼如下：

typedefstruct{ADAPTER_STATUSadapt;NAME_BUFFERNameBuff[30];}ASTAT;參數(shù)adapt表示網(wǎng)絡適配器的狀態(tài)信息，參數(shù)NameBuff表示網(wǎng)絡適配器中保存的本地網(wǎng)絡名字信息。SUP-4.2.4Netbios()函數(shù)Netbios()函數(shù)用于解釋和執(zhí)行指定的網(wǎng)絡控制塊（NCB），語法如下：

UCHAR

Netbios(__inPCNBpcnb);

參數(shù)pcnb是指定NCB結(jié)構(gòu)體的指針，用于描述網(wǎng)絡控制塊。如果執(zhí)行同步請求命令，則函數(shù)的返回值為NCB結(jié)構(gòu)體的編碼。該值也保存在NCB結(jié)構(gòu)體的ncb_retcode字段中。

異步請求的返回值有以下兩種情況：（1）如果Netbios()返回時異步命令已經(jīng)完成，則返回值為NCB結(jié)構(gòu)體的編碼，這與同步請求的返回值相同。（2）如果Netbios()返回時異步命令尚未完成，則返回值為0。如果pncb參數(shù)中指定的地址無效，則返回NRC_BADNCB。如果NCB結(jié)構(gòu)體中ncb_length字段指定的緩沖區(qū)長度不正確，或者緩沖區(qū)不允許執(zhí)行寫操作，則返回NRC_BUFLEN。SUP-4.2.5獲取LANA上的所有NetBIOS名字【例】編寫程序，向本地名字表中添加一個名字UNIQUENAME，然后列出指定LANA0中定義的所有NetBIOS名字。第1個名字是本地計算機名，第2個名字是本地計算機所屬的工作組名，最后一個名字是新添加的NetBIOS名字。下面對本實例中的代碼進行介紹。

1．引用的頭文件和庫文件#include""#include<>#include<>#include<>#include<Nb30.h>#pragmacomment(lib,"netapi32.lib")

其中是定義NetBIOS結(jié)構(gòu)體和函數(shù)的頭文件，而則是NetBIOS編程所需要的靜態(tài)庫文件。2．常量和宏定義#defineLANANUM0 //本實例中操作的LANA編號//本實例中添加的名字，注意不能與本地計算機重名#defineLOCALNAME"UNIQUENAME“#defineNBCheck(x)if(NRC_GOODRET!=){\printf("Line%d:Got0x%xfromNetBios()\n",\__LINE__,);\}在使用宏NBCheck時，使用ncb結(jié)構(gòu)體為參數(shù)。ncb結(jié)構(gòu)體的ncb_retcode參數(shù)表示調(diào)用Netbios()函數(shù)的返回值。如果返回值不等于NRC_GOODRET，則表示函數(shù)調(diào)用失敗，需要輸出發(fā)生錯誤的行號和函數(shù)返回值，以便用戶定位問題。3．NBReset()函數(shù)BOOLNBReset(intnLana,intnSessions,intnNames){NCBncb;//初始化ncb結(jié)構(gòu)體memset(&ncb,0,sizeof(ncb)); //清空ncb結(jié)構(gòu)體=NCBRESET; //執(zhí)行NCBRESET命令=0; //分配新的lana_num資源=nLana; //設置lana_num資源ncb.ncb_callname[0]=nSessions;//設置最大會話數(shù)ncb.ncb_callname[2]=nNames; //設置最大名字數(shù)Netbios(&ncb); //執(zhí)行NCBRESET命令NBCheck(ncb); //如果執(zhí)行結(jié)果不正確，則輸出//如果成功返回TRUE，否則返回FALSEreturn(NRC_GOODRET==);}4．NBAddName()函數(shù)BOOLNBAddName(intnLana,LPCSTRszName){NCBncb;memset(&ncb,0,sizeof(ncb)); //清空ncb結(jié)構(gòu)體=NCBADDNAME; //執(zhí)行NCBDDNAME命令=nLana; //設置lana_num//將szName賦值到中MakeNetbiosName((char*),szName);Netbios(&ncb); //執(zhí)行NCBRESET命令NBCheck(ncb);//如果執(zhí)行結(jié)果不正確，則輸出 //如果成功返回TRUE，否則返回FALSEreturn(NRC_GOODRET==);}MakenetbiosName()函數(shù)//將szSrc中的名字賦值到achDest中，名字的長度為NCBNAMESZ//如果不足，則使用空格補齊voidMakeNetbiosName(char*achDest,LPCSTRszSrc){intcchSrc;

cchSrc=lstrlen(szSrc);if(cchSrc>NCBNAMSZ)cchSrc=NCBNAMSZ;

memset(achDest,'',NCBNAMSZ);memcpy(achDest,szSrc,cchSrc);}

5．NBAdapterStatus()函數(shù)//獲取指定LANA的網(wǎng)絡適配器信息//nLana,LANA編號//pBuffer,獲取到的網(wǎng)絡適配器緩沖區(qū)//cbBuffer,緩沖區(qū)長度//szName,主機名字BOOLNBAdapterStatus(intnLana,PVOIDpBuffer,intcbBuffer,LPCSTRszName){NCBncb; memset(&ncb,0,sizeof(ncb)); //清空ncb結(jié)構(gòu)體=NCBASTAT;//設置執(zhí)行NCBASTAT命令=nLana;//設置LANA編號//將獲取到的數(shù)據(jù)保存到參數(shù)pBuffer中=(PUCHAR)pBuffer;=cbBuffer;//設置緩沖區(qū)長度//設置參數(shù)MakeNetbiosName((char*),szName);Netbios(&ncb); //執(zhí)行NetBIOS命令NBCheck(ncb); //如果執(zhí)行不成功，則輸出返回值//如果成功返回TRUE，否則返回FALSEreturn(NRC_GOODRET==);}6．NBListNames()函數(shù)BOOLNBListNames(intnLana,LPCSTRszName){intcbBuffer; //獲取數(shù)據(jù)的緩沖區(qū)ADAPTER_STATUS*pStatus; //保存網(wǎng)絡適配器的信息NAME_BUFFER*pNames; //保存本地名字信息HANDLEhHeap; //當前調(diào)用進程的堆句柄

//當前調(diào)用進程的堆句柄hHeap=GetProcessHeap();//分配可能的最大緩沖區(qū)空間cbBuffer=sizeof(ADAPTER_STATUS)+255*sizeof(NAME_BUFFER); //為pStatus分配空間pStatus=(ADAPTER_STATUS*)HeapAlloc(hHeap,0,cbBuffer);if(NULL==pStatus)returnFALSE;//獲取本地網(wǎng)絡適配器信息，結(jié)果保存到pStatus中if(!NBAdapterStatus(nLana,(PVOID)pStatus,cbBuffer,szName)){HeapFree(hHeap,0,pStatus);returnFALSE;}//列出跟在ADAPTER_STATUS結(jié)構(gòu)體后面的名字信息pNames=(NAME_BUFFER*)(pStatus+1);for(inti=0;i<pStatus->name_count;i++)printf("\t%.*s\n",NCBNAMSZ,pNames[i].name); //釋放分配的堆空間HeapFree(hHeap,0,pStatus);

returnTRUE;}6．NBListNames()函數(shù)程序的運行過程如下：獲取當前進程的堆句柄，然后在堆上分配可能的最大緩沖區(qū)空間，即一個ADAPTER_STATUS結(jié)構(gòu)體占用的空間加上255個NAME_BUFFER結(jié)構(gòu)體占用的空間。在執(zhí)行NCBASTAT命令時，可以返回一個ADAPTER_STATUS結(jié)構(gòu)體和一組（最多255個）NAME_BUFFER結(jié)構(gòu)體。調(diào)用NBAdapterStatus()函數(shù)，獲取本地網(wǎng)絡適配器信息，結(jié)果保存到pStatus結(jié)構(gòu)體中。在pStatus結(jié)構(gòu)體后面緊跟著的是一組NAME_BUFFER結(jié)構(gòu)體，將pName指針指向第1個NAME_BUFFER結(jié)構(gòu)體。pStatus->name_count中保存著pStatus后面NAME_BUFFER結(jié)構(gòu)體的數(shù)量。使用for語句遍歷這些結(jié)構(gòu)體，輸出NAME_BUFFER結(jié)構(gòu)體中的名字信息。釋放分配的堆空間。SUP-4._tmain()函數(shù)int_tmain(intargc,_TCHAR*argv[]){ //初始化 if(!NBReset(LANANUM,20,30)) return-1; //向本地名字表中添加UNIQUENAME if(!NBAddName(LANANUM,LOCALNAME)) return-1; //列出本地名字表中的名字 if(!NBListNames(LANANUM,LOCALNAME)) return-1; printf("Succeeded.\n"); system("pause"); return0;}SUP-4.2.6獲取網(wǎng)絡適配器上的MAC地址【例】編寫程序，獲取網(wǎng)絡適配器上的MAC地址。1．引用的頭文件和庫文件#include""#include<>#include<>#include<Nb30.h>#pragmacomment(lib,"netapi32.lib")2．結(jié)構(gòu)體ASTAT結(jié)構(gòu)體ASTAT用于定義網(wǎng)絡適配器狀態(tài)和名字表信息，代碼如下：

typedefstruct_ASTAT_{ADAPTER_STATUSadapt;NAME_BUFFERNameBuff[30];}ASTAT,*PASTAT;ASTATAdapter;

ASTAT結(jié)構(gòu)體變量Adapter用于保存執(zhí)行NCBASTAT命令獲取到的網(wǎng)絡適配器狀態(tài)和名字表信息。3．_tmain()函數(shù)int_tmain(intargc,_TCHAR*argv[]){ NCBncb; //NCB結(jié)構(gòu)體，用于設置執(zhí)行的NetBIOS命令和參數(shù)UCHARuRetCode; //執(zhí)行Netbios()函數(shù)的返回值memset(&ncb,0,sizeof(ncb)); //初始化ncb結(jié)構(gòu)體=NCBRESET; //設置執(zhí)行NCBRESET=0; //設置LANA編號//調(diào)用Netbios()函數(shù)，執(zhí)行NCBRESET命令uRetCode=Netbios(&ncb);//輸出執(zhí)行NCBRESET命令的結(jié)果printf("TheNCBRESETreturncodeis:0x%x\n",uRetCode);memset(&ncb,0,sizeof(ncb)); //初始化ncb=NCBASTAT; //執(zhí)行NCBASTAT命令=0; //設置LANA編號//設置執(zhí)行NCBASTAT命令的參數(shù)，將獲取到的網(wǎng)絡適配器數(shù)據(jù)保存到Adapter結(jié)構(gòu)體中memcpy(&,"*",16);=(UCHAR*)&Adapter;=sizeof(Adapter);//調(diào)用Netbios()函數(shù)，執(zhí)行NCBASTAT命令uRetCode=Netbios(&ncb);printf("TheNCBASTATreturncodeis:0x%x\n",uRetCode);3．_tmain()函數(shù)if(uRetCode==0){//輸出MAC地址printf("TheEthernetNumberis:%02x-%02x-%02x-%02x-%02x-%02x\n",Adapter.adapt.adapter_address[0],Adapter.adapt.adapter_address[1],Adapter.adapt.adapter_address[2],Adapter.adapt.adapter_address[3],Adapter.adapt.adapter_address[4],Adapter.adapt.adapter_address[5]);}system("pause");return0;}程序的運行過程執(zhí)行NCBRESET命令，清空本地的名字表和會話表。執(zhí)行NCBASTAT命令獲取網(wǎng)絡適配器信息。依次打印數(shù)組[]中的元素值，即輸出MAC地址。SUP-4.3在程序中實現(xiàn)NBTSTAT命令的功能SUP-4.3.1本實例的工作原理SUP-4.3.2定義的結(jié)構(gòu)體SUP-4.3.3為獲取NetBIOS信息而定義的函數(shù)SUP-4.3.4實現(xiàn)NBTSTAT命令功能的主函數(shù)SUP-4.3.1本實例的工作原理SUP-4.3.2定義的結(jié)構(gòu)體1．names結(jié)構(gòu)體2．workstationNameThreadStruct結(jié)構(gòu)體1．names結(jié)構(gòu)體names結(jié)構(gòu)體用于接收目標計算機發(fā)送回來的名字信息，代碼如下：

structnames{ unsignedcharnb_name[16]; unsignedshortname_flags;};參數(shù)nb_name表示接收到的名字，name_flags用于標識名字的含義。2．workstationNameThreadStruct結(jié)構(gòu)體workstationNameThreadStruct結(jié)構(gòu)體用于保存獲取NetBIOS信息的套接字和IP地址列表，代碼如下：

structworkstationNameThreadStruct{ SOCKETs; std::map<unsignedlong,CDevice*>*ips;};

參數(shù)s指定發(fā)送和接收NetBIOS數(shù)據(jù)包的套接字，參數(shù)ips指定獲取NetBIOS信息的IP地址列表。SUP-4.3.3為獲取NetBIOS信息而定義的函數(shù)為了獲取遠程計算機的NetBIOS信息，在程序中需要向指定的IP地址發(fā)送NetBIOS請求包，然后創(chuàng)建一個線程來接收返回的NetBIOS回應包，最后將回應包中的信息解析成需要的數(shù)據(jù)。本節(jié)介紹實現(xiàn)這些功能的3個函數(shù)。1．GetHostInfo()函數(shù)2．NetBiosRecvThreadProc()函數(shù)3．GetEthernetAdapter()函數(shù)1．GetHostInfo()函數(shù)voidGetHostInfo(std::map<unsignedlong,CDevice*>&ips,inttimeout){SOCKETsock; //通信套接字structsockaddr_inorigen; //本地地址WSADATAwsaData; //WindowsSockets環(huán)境變量

//初始化WindowsSockets環(huán)境if(WSAStartup(MAKEWORD(2,1),&wsaData)!=0)return;//創(chuàng)建TCP/IP套接字if((sock=socket(AF_INET,SOCK_DGRAM,IPPROTO_UDP))==INVALID_SOCKET)return;//設置超時時間if(setsockopt(sock,SOL_SOCKET,SO_RCVTIMEO,(char*)&timeout,sizeof(timeout))==SOCKET_ERROR){//釋放資源closesocket(sock);WSACleanup();return;}……1．GetHostInfo()函數(shù) //將套接字綁定到本地地址和端口 memset(&origen,0,sizeof(origen)); =AF_INET; =htonl(INADDR_ANY); =htons(0); if(bind(sock,(structsockaddr*)&origen,sizeof(origen))<0) { //釋放資源 closesocket(sock); WSACleanup(); return; }

//為創(chuàng)建接收線程準備數(shù)據(jù) workstationNameThreadStructunionStruct; =&ips; =sock;1．GetHostInfo()函數(shù) //啟動線程等待接收NetBIOS回應包 DWORDpid; HANDLEthreadHandle=CreateThread(NULL,0,NetBiosRecvThreadProc,(void*)&unionStruct,0,&pid);

//依次向ips中的每個IP地址的端口發(fā)送NetBIOS請求包（保存在input字符數(shù)組中） std::map<unsignedlong,CDevice*>::iteratoritr; for(itr=ips.begin();itr!=ips.end();itr++) { charinput[]="\x80\x94\x00\x00\x00\x01\x00\x00\x00\x00\x00\x00\x20\x43\x4b\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x00\x00\x21\x00\x01"; structsockaddr_indest; //發(fā)送NetBios請求信息 memset(&dest,0,sizeof(dest)); =itr->first; =AF_INET; =htons(137); sendto(sock,input,sizeof(input)-1,0,(structsockaddr*)&dest,sizeof(dest)); }1．GetHostInfo()函數(shù) //等待接收線程NetBiosRecvThreadProc結(jié)束 DWORDret=WaitForSingleObject(threadHandle,timeout*4); //如果超時，則結(jié)束接收線程NetBiosRecvThreadProc if(ret==WAIT_TIMEOUT) Terminat