windows network library
建立本工程的目的。
这是一个应用层的收集(本地/本机)各种网路操作的集合,主要是API的用法,枚举和信息的收集。
注意:这不是一个扫描器,可以说是本地(本机)网络信息查看器。
本仓库办包含的内容:
- socket(raw)
- Spi(lsp)
- wfp 应用层,不包含驱动层。
- wlan(wifi)
- winhttp(proxy)
- wininet
- netblos 不包含驱动层。
- IpHelper 不包含驱动层。
- html
- firewall
- Netapi
- netsh 有待添加。
本仓库不包含的内容:
- 命名管道
- 邮件槽
- TDI
- WSK
- WFP 的 驱动层
- NDIS
- SSPI 驱动层和应用层都不包含。
本库的设计的几个规则:
- 尽量不调用日志函数。
刚开始的时候还考虑是否使用日志,以及何种日志。 - 因为上一条,所以代码失败要返回详细的信息,也就是失败的原因。
- 因为上两条的原因,所以使用者要检查返回值,并记录日志。
- 代码不会主动抛异常。代码尽量屏蔽异常。但是不代表代码中没有异常。
代码尽量捕捉异常并返回信息。 - 导出(对外公开的)的函数都是NTAPI调用格式。
- 代码尽量使用SAL(source-code annotation language:源代码批注语言)。
- 代码格式类似go和python.
- 代码尽量不使用硬编码。
- 代码开启静态的语法检查(启用Microsoft Code Analysis, 关闭Clang-Tidy)。
- 警告的等级是4级,且将警告视为错误。
- 代码的运行要过:驱动程序校验器/应用程序校验器/gflags.exe.
- 禁止使用断言(估计现在代码中还有不少断言)。
- 接口的参数只有基本类型和指针(没有类,模板和引用)。
- 只依赖操作系统的库,不再依赖第三方的库(特指动态库),当然crt,wil不可免。
- 所有接口皆为C接口,即EXTERN_C。
- C语言标准选择:ISO C17 (2018)标准 (/std:c17)。
- C++语言标准选择:ISO C++17 标准 (/std:c++17) 或者:预览 - 最新 C++ 工作草案中的功能 (/std:c++latest)。
特别说明:
本库只提供c/c++/rust调用接口文档,
其他的,如:ASM,C#,GO,PYTHON,JAVA,PHP等自行定义。
注意:接口或者回调的调用方式。__stdcall or __cdecl or __fastcall。
为了彰显本程序库的力量,特添加一个工程:
- 利用本程序库的功能而制作一个程序。
- 这个程序主要是显示网络信息,但还有别的功能。
- 这个程序没有利用驱动。
- 这个程序的名字叫:NetTool.exe吧!叫NetInfo.exe的格局有点小。
- 重写操作系统自带的网络工具,添加或扩展功能,修改BUG,至少显示给改进下(对齐,错位)。