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)