IStats::QueryStatus 方法
QueryStatus 方法检索 NPP 的状态。
语法
HRESULT STDMETHODCALLTYPE QueryStatus(
[out] NETWORKSTATUS *pNetworkStatus
);
参数
-
pNetworkStatus [out]
-
指向返回的 NETWORKSTATUS 结构的指针,该结构指示当前状态 (捕获、暂停、停止等) NPP。 应用程序负责为 NETWORKSTATUS 结构分配和释放内存。
返回值
如果方法成功,则返回值NMERR_SUCCESS。
如果 方法不成功,则返回值为以下错误代码:
返回代码 | 说明 |
---|---|
|
pNetworkStatus 参数未指向有效的 NETWORKSTATUS 结构。 为此结构分配内存,并再次调用 IStats::QueryStatus 方法。 |
备注
在调用 CreateNPPInterface 方法后,可以随时调用此方法。 可以调用它来查看 NPP 是否已连接到网络,了解当前捕获的状态,并查看是否有任何触发器处于挂起状态。 但是,在调用此方法之前,必须分配 NETWORKSTATUS 结构所需的内存,并在不再需要该结构时释放该内存。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
标头 |
|
DLL |
|