WSStopRegisteringLinkService （C 函数）

void WSStopRegisteringLinkService(WSENV e, WSLINK l, WSServiceRef r)

中止由 r 表示的 WSTP 网络链接服务注册操作（WSTP network link service registration operation）并关闭链接 l.

更多信息

  • 注册链接服务名称本质上是一个异步操作. WSRegisterLinkService()，WSRegisterLinkServiceWithHostname() 和 WSRegisterLinkServiceWithPortAndHostname() 开始注册操作，并立即返回. WSTP 库会用注册的状态更新回调到该应用.
  • 链接服务名称注册会继续运行，直到程序调用 WSStopRegisteringLinkService() 或操作系统的服务浏览机制（service browsing mechanism）发生错误.
  • 一旦程序调用了 WSStopRegisteringLinkService()，然后它应该会作废或删除任何缓存的服务名称和与该服务相关的资源.
  • 参考对象 r 必须与 WSRegisterLinkService()，WSRegisterLinkServiceWithHostname()或 WSRegisterLinkServiceWithPortAndHostname() 返回的对象一样.

范例

基本范例  (1)

#include "wstp.h"

void RegisterCallbackFunction(WSENV e, WSServiceRef ref, const char *name, void *context);

void managerRegisterOperation(WSENV e, const char *serviceName)
{
    WSServiceRef theRef;
    WSLINK theLink;
    int error;

    theLink = WSRegisterLinkService(e, serviceName,
        RegisterCallbackFunction, NULL /* Use the default domain */,
        NULL /* No context for this example */, &theRef, &error);

    if(theLink == NULL || error != WSEOK)
    { /* Handle the error */ }

    /* ... */

    WSStopRegisteringLinkService(e, theLink, theRef);
}


void RegisterCallbackFunction(WSENV e, const char *name, void *context)
{
    ...
}