Packet32 包中的函數說明 :

No.1. ? PacketGetAdapterNames( 從注冊表中讀取網卡名 )

得到現有的網絡適配器的列表和它們的描述。

BOOLEAN PacketGetAdapterNames(

PTSTR pStr,

PULONG ? BufferSize

)；

Parameters ：

pStr:

[in , out] 一塊用戶負責分配的緩沖區，將把適配器的名字填充進去。

BufferSize:

[in] pStr 這塊緩沖區的大小。

Return Values ：

如果查詢成功，返回一個非零值。

Usage:

[C/C++]

C/C++ Usage Sample

char ????????????? ??? AdapterNamea[8192];

ULONG ? ?????? AdapterLength;

PacketGetAdapterNames(AdapterName,&AdapterLength);

                    
                      ?
          
            
                      
                      
                    
                  

Remarks:

通常，這都是與網卡通信時要調用的第一個函數。它返回系統上安裝了的網卡的名字。在每個網卡的名字后面， pStr 中還有一個與之相應的描述。

由于結果都是通過查詢注冊表得到的，所以 WindowsNTx 和 Windows9X/Me 下得到的字符串編碼是不同的。 Windows9X 下用 ASCII 編碼存儲，而 WindowsNTx 則是 Unicode 。

如果是在 Windows9X 下，調用完 PacketGetAdapterNames 后，得到的 pStr 將是這樣的：

- ????????? 一串用 "\0" 分隔的 ASCII 字符串，每一個都是一個網卡的名字；

- ????????? 兩個 "\0" ；

- ????????? 一串用 "\0" 分隔的 ASCII 字符串，每一個都是一個網卡的描述；順序是和網卡名字一樣的；

- ????????? 兩個 "\0" ；

?

如果是在 WindowsNTx 下，調用完 PacketGetAdapterNames 后，得到的 pStr 將是這樣的：

- ????????? 一串用一個 Unicode 的 "\0" 分隔的 Unicode 字符串，每一個都是一個網卡的名字；

- ????????? 兩個 Unicode 的 "\0" ；

- ????????? 一串用 ASCII 的 "\0" 分隔的 ASCII 字符串，每一個都是一個網卡的描述；順序是和網卡名字一樣的；

- ????????? 兩個 ASCII 的 "\0" ；

?

這個函數的操作大致為：

網卡的注冊表項是：

HKEY_LOCAL_MACHINE\

SYSTEM\

CurrentControlSet\

Control\

Class\

{4D36E972-E325-11CE-BFC1-08002BE10318}

? ???? 先打開這個鍵值；

?????? 再枚舉下面的每一項，依次讀取參數：

?????? 對 子項 \Linkage\UpperBind 參數，核對是否等于 ” NdisWan” ，如果不是，就跳過去；

?????? 如果是 ” NdisWan” ，則讀取 子項 \Linkage\Export ，這就是網卡的名字。

?

?????? 如果前面的查詢有網卡記錄，那么執行下面這個循環：

?????? 將調用 PacketOpenAdapter 打開每個網卡；

其中將調用 PacketRequest(adapter,FALSE,OidData) 來得到網卡的描述；

具體方法是這樣， OidData 是一個 PACKET_OID_DATA 結構，我們事先設置它的 Oid 成員為 OID_GEN_VENDOR_DESCRIPTION ，然后調用 PacketRequest 把這個 OID 發送給網卡 driver ，就可以從 OidData->Data 中拿到網卡的描述了。

?????? 最后調用 PacketCloseAdapter 關閉適配器。

??????

?????? 如果前面沒有查詢到網卡記錄，那么執行我們將根據 TCP/IP Binding 來查找網卡：

?????? 先打開這個鍵值；

HKEY_LOCAL_MACHINE\

SYSTEM\

CurrentControlSet\

Services\

Tcpip\

Linkage

它的 Bind 參數設置的就是現在系統上綁定的網卡的名字。

得到名字之后，同上調用 PacketOpenAdapter 和 PacketRequest 方法向網卡查詢它的描述。

(To be continued)