4.8.1 tpalloc型付きバッファの割り当て

<この項の構成>
(1) 形式
(2) 機能
(3) UAPで値を設定する引数
(4) リターン値
(5) 注意事項

(1) 形式

(a) TP1/Client/Wの場合

#include <dcvxatmi.h>
char *tpalloc(char *type, char *subtype, DCLONG size)

(b) TP1/Client/Pの場合

#include <dcvxatmi.h>
char CLTFAR *tpalloc(char CLTFAR *type, char CLTFAR *subtype, DCLONG size)

(2) 機能

型付きのバッファを割り当てます。

バッファの型によっては,使用する前に初期化が必要なものがあります。tpalloc関数は,バッファが割り当てられてからリターンするまでの間に,バッファを初期化します。関数を呼び出せる状態になってから,バッファはtpalloc関数を呼び出した側にリターンされます。

初期化の方法は,TP1/ClientおよびTP1/Server Baseのコミュニケーションリソースマネジャ(CRM)で定義します。定義されていない場合,tpalloc関数はバッファを初期化しません。

初期化が正常に完了した場合,tpalloc関数は,longワードに位置合わせした適切な形式のバッファへのポインタをリターンします。エラー時には,NULLをリターンし,リターン値としてエラー情報が返されます。初期化が失敗すると,割り当てられたバッファは解放され,NULLをリターンします。

(3) UAPで値を設定する引数

(4) リターン値

正常に完了した場合,tpalloc関数は,longワードに位置合わせした適切な形式のバッファへのポインタをリターンします。エラー時には,NULLをリターンし,リターン値としてエラー情報を示す次のどれか一つの値を,tperrnoに設定します。

リターン値意味
TPEINVAL引数に誤りがあります。
TPENOENT引数に指定された値は,システムで定義されていません。
TPEPROTOtpalloc関数を呼び出すときの状態が適切ではありません。
TPESYSTEMコミュニケーションリソースマネジャでエラーが発生しました。
TPEOSオペレーティングシステムでエラーが発生しました。

(5) 注意事項