WSServiceRef (C 関数)
サービス発見ブラウズ操作,サービス変換操作,サービス登録操作への参照を含むWSTPのタイプである.
詳細
- WSTPサービスの発見設備には,使用可能なWSTPサービスをブラウズすること,名前付きのサービスのリンク接続詳細を解決すること,名前付きの WSTPサービスを登録(あるいは通知)することという3つの主な操作が含まれる.WSTPは,これらのサービス発見動作のそれぞれを非同期的に行う.WSTPライブラリは,提供されたコールバック関数を通じてプログラムへのコールバックを行う.WSServiceRefオブジェクトには,それぞれの操作を追跡するのに必要なデータが含まれる.
- WSBrowseForLinkServices()とWSStopBrowsingForLinkServices()は,リンクサービスのブラウズ操作を開始,終了する.
- WSResolveLinkService()とWSStopResolvingLinkService()は,特定のリンクサービスの変換操作を開始,終了する.
- WSRegisterLinkServiceWithPortAndHostname(),WSRegisterLinkServiceWithHostname(), WSRegisterLinkService() は,リンクサービスの登録(あるいは通知)を開始するのに対し,WSStopRegisteringLinkService()は,サービス登録操作を終了する.
例題
例 (1)
#include "wstp.h"
void BrowseCallbackFunction(WSENV env, WSServiceRef ref, int flag, const char *name, void *context);
WSServiceRef browseForServices(WSENV e)
{
int apiResult = 0;
WSServiceRef ref;
apiResult = WSBrowseForLinkServices(e, BrowseCallbackFunction, NULL /* Use the default browse domain */, NULL /* do not use a context object this time */, &ref);
if(apiResult != 0)
{ /* Handle the error */
return ref;
}