WSStopBrowsingForLinkServices (C 函数)
void WSStopBrowsingForLinkServices(WSENV e,WSServiceRef r)
中止用 r 表示的 WSTP 网络链接服务浏览操作.
更多信息
- 浏览链接服务本质上是一个异步操作. 调用 WSBrowseForLinkServices() 可开始浏览操作. 当网络浏览事件发生时,WSTP 库会回调一个准备好的回调函数. WSBrowseForLinkServices() 并不等着浏览操作完成,而是在开始浏览操作后立即返回调用者.
- 这个网络浏览操作会持续运行,直到程序调用 WSStopBrowsingForLinkServices() 或操作系统的服务浏览机制发生了错误.
- 如果用 WSBrowseForLinkServices() 注册的浏览回调函数接收到错误标记 WSSDBROWSEERROR,则要调用 WSStopBrowsingForLinkServices() 来停止此次浏览操作.
- 一旦程序调用了 WSStopBrowsingForLinkServices(),就应再作废或删除任何缓存的服务名称.
- 参考对象 r 必须与由 WSBrowseForLinkServices() 返回的对象为同一对象.
范例
基本范例 (1)
#include "wstp.h"
void BrowseCallbackFunction(WSENV e, WSServiceRef ref, const char *serviceName, void *context);
void manageBrowseOperation(WSENV e)
{
WSServiceResult theRef;
int apiResult = 0;
apiResult = WSBrowseForLinkServices(e, BrowseCallbackFunction, NULL /* Use the default browse domain */, NULL /* do not use a context object in this example */, &theRef);
if(apiResult != 0)
{ /* Handle the error */ }
/* ... */
WSStopBrowsingForLinkServices(e, theRef);
}
void BrowseCallbackFunction(WSENV e, WSServiceRef ref, const char *serviceName, void *context)
{
...
}