tptypes
名称
型付きバッファの情報の取得
形式
ANSI C ,C++ の形式
#include <xatmi.h>
long tptypes(char *ptr,char *type,char *subtype)
K&R版 Cの形式
#include <xatmi.h>
long tptypes(ptr,type,subtype)
char *ptr;
char *type;
char *subtype;
機能
関数tptypes()は,引数ptrにデータを格納したバッファへのポインタを設定して,引数type,subtypeにそれぞれバッファのタイプとサブタイプをリターンします。ptrはtpalloc()から得たバッファへのポインタです。typeとsubtypeがNULLでない場合は,この関数はそれぞれが指しているタイプとサブタイプの名称を文字配列に格納します。名称が最大長(typeは8バイト,subtypeは16バイト)の場合,文字配列の終わりにはNULLを入れません。サブタイプがない場合は,subtypeが指す配列はNULL文字列("")です。
『引数』
『●ptr
バッファへのポインタを設定します。』
『●type
バッファのtypeへのポインタを設定します。』
『●subtype
バッファのsubtypeへのポインタを設定します。』
リターン値
成功した場合,tptypes()はバッファのサイズをリターンします。エラー時には,tptypes()は-1をリターンして,tperrnoにエラーの状態を示す値を設定します。
エラー
次のような場合,tptypes()はエラーリターンして,次のうちどれか一つの値をtperrnoに設定します。
リターン値 | リターン値(数値) | 意味 |
---|---|---|
TPEINVAL | 4 | 間違った引数が与えられました(例えば,ptrが型付きバッファへのポインタではない)。 |
TPEOS | 7 | オペレーティングシステムにエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。 |
TPEPROTO | 9 | tptypes()が間違った状況で呼ばれました。 |
TPESYSTEM | 12 | コミュニケーションリソースマネジャシステムでエラーが起こりました。厳密なエラーの性質は,product-specificな方法で定義されます。 |
関連項目
tpalloc(),tpfree(),tprealloc()
『OpenTP1で使う場合の注意事項』