tpunadvertise
形式
ANSI C ,C++ の形式
#include <xatmi.h> int tpunadvertise(char *svcname)
K&R版 Cの形式
#include <xatmi.h> int tpunadvertise(svcname) char *svcname;
機能
関数tpunadvertise()は,あるサーバにそのサーバで提供する,あるサービスの広告を取り消すことを許可します。この関数を呼び出さない場合,サーバのサービスは,ブート時に広告されて,シャットダウンされたときに広告を取り消されます。
関数tpunadvertise()は,サーバで宣伝していたsvcnameを削除します。svcnameには,NULLやNULL文字列("")は使えません。また,svcnameは15文字以下になるようにしてください。svcnameが15文字よりも長い場合は,15文字に切り詰められます。切り詰められた名称がほかのサービス名と一致しないようにしてください。
『引数』
『●svcname
サービスのサービス名を設定します。』
リターン値
エラー時には,-1をリターンして,tperrnoにエラーの状態を示す値を設定します。
エラー
次のような場合,tpunadvertise()はエラーリターンして,次のうちどれか一つの値をtperrnoに設定します。
リターン値 |
リターン値(数値) |
意味 |
---|---|---|
TPEINVAL |
4 |
引数svcnameがNULLかNULL文字("")が設定されています。 |
TPENOENT |
6 |
引数svcnameは,現在このサーバで広告されていません。 |
TPEOS |
7 |
オペレーティングシステムにエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。 |
TPEPROTO |
9 |
tpunadvertise()が間違った状況で呼ばれました。 |
TPESYSTEM |
12 |
コミュニケーションリソースマネジャシステムでエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。 |
関連項目
tpadvertise()
『OpenTP1で使う場合の注意事項』
-
『一つのノードで負荷分散している場合(マルチサーバ),tpunadvertise()をどれか一つのプロセスが呼び出すと,負荷分散しているプロセスすべてでサービスを受け付けられなくなります。その後,tpadvertise()で再びサービスを広告すれば,サービス要求を受け付けられるようになります。』
-
『OSI TP通信をするXATMIのエラーは,従来のTCP/IPとエラー動作が異なる場合があります。』