IStats：：Connect 方法
Connect 方法使用指定的 NIC 将 NPP 连接到网络，并提供连接的配置信息。
语法
HRESULT STDMETHODCALLTYPE Connect(
[in] HBLOB hInputBlob,
[in] LPVOID StatusCallbackProc,
[in] LPVOID UserContext,
[out] HBLOB hErrorBlob
);
参数
-
hInputBlob [in]
-
BLOB 的句柄，该 BLOB 指定 NPP 连接到的 NIC 以及该连接的配置信息。
-
StatusCallbackProc [in]
-
接收状态更新（如触发器）的用户回调函数的地址。 如果未使用回调函数，请将此参数和 UserContext 参数设置为 NULL。
-
UserContext [in]
-
调用用户的回调函数时传递的值。 此参数的值通常是 HWND 或“this”指针。 如果未指定回调函数，请将此参数和 StatusCallbackProc 参数设置为 NULL。
-
hErrorBlob [out]
-
包含其他错误信息的错误 BLOB 的句柄。
返回值
如果方法成功，则返回值NMERR_SUCCESS。
如果 方法不成功，则返回值是以下错误代码之一 (其中包括内部 IStats：：Configure 调用) 返回的错误：
| 返回代码 | 说明 |
|---|---|
|
NPP COM 对象的此实例已连接到网络。 |
|
配置 BLOB 已损坏。 此错误由 IStats：：Configure 调用生成。 |
|
由 hInputBlob 参数指定的输入 BLOB 缺少执行此操作所需的条目。 此错误可能是由 IStats：：Connect 或 IStats：：Configure 调用生成的。 查看 hErrorBlob 返回的错误 BLOB 以确定找不到哪个条目。 |
|
尚未调用 CreateBlob 函数。 此错误由 IStats：：Configure 调用生成。 |
|
字符串不是以 null 结尾的。 此错误由 IStats：：Configure 调用生成。 |
|
输入 BLOB 的触发器部分已损坏。 此错误由 IStats：：Configure 调用生成。 |
|
hInputBlob 中指定的对象不是 BLOB。 此错误由 IStats：：Configure 调用生成。 |
|
未在注册表中设置默认捕获目录。 若要设置捕获目录，请使用以下路径。 |
|
执行此操作所需的内存不可用。 此错误由 IStats：：Configure 调用生成。 |
|
请求已超时。此错误由 IStats：：Configure 调用生成。 |
|
hInputBlob 中指定的 BLOB 的版本号不正确。 此错误由 IStats：：Configure 调用生成。 |
备注
调用 Connect 方法时，网络监视器使用 hInputBlob 参数提供的 BLOB 自动调用 IStats：：Configure 方法。 请注意，调用 IStats：：Configure 返回的任何错误代码都传递回，并由 IStats：：Connect 调用返回。
必须先调用此方法，然后才能开始捕获帧。 请注意，使用此方法连接到网络时，必须继续使用 IStats 接口捕获帧。
可以通过调用 GetNPPBlobFromUI、GetNPPBlobTable 和 SelectNPPBlobFromTable 方法获取 hInputBlob 指定的输入 BLOB。
hErrorBlob 参数返回的错误 BLOB 包含网络监视器无法理解或在 hInputBlob 中指定的输入 BLOB 中找到的条目。 返回的错误 BLOB 包含应用程序可用于故障排除的错误信息。 例如，如果返回NMERR_BLOB_ENTRY_DOES_NOT_EXIST，则网络监视器找不到的条目将包含在返回的错误 BLOB 中。
| 有关以下方面的信息 | 请参阅 |
|---|---|
| 获取表示网络接口的输入 BLOB 卡 | 选择网络接口卡 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
| 标头 |
|
| DLL |
|