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とエラー動作が異なる場合があります。』