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で使う場合の注意事項』