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)
{
    ...
}