rpc_sm_set_client_alloc_free、 rpc_ss_set_client_alloc_free(3c)

名前

rpc_sm_set_client_alloc_free()、rpc_ss_set_client_alloc_free()-クライアントのスタブが使用するメモリ管理および開放の機構を設定する

形式

#include <rpc/rpc.h>  
void rpc_sm_set_client_alloc_free(
   idl_void_p_t (*p_allocate)(unsigned long size),
   void (*p_free) (idl_void_p_t ptr), unsigned32 *status)
 
void rpc_ss_set_client_alloc_free(
   idl_void_p_t (*p_allocate)(unsigned long size),
   void (*p_free) (idl_void_p_t ptr))

機能説明

rpc_sm_set_client_alloc_free() は、クライアントのスタブがメモリ管理に使用するデフォルトのルーチンよりも優先されます。入力パラメータ p_allocate および p_free には、メモリの割り当ておよび開放のルーチンを指定します。サーバのコード中でリモート・コールが発生する場合 (この場合、メモリ管理ルーチンは rpc_ss_allocate(3) および rpc_ss_free(3) でなければなりません) を除いて、デフォルトのメモリ管理ルーチンは ISO C の malloc() および free() になります。

出力パラメータ status には、このルーチンからのステータス・コードが返されます。このステータス・コードは、ルーチンが成功して完了したか、または失敗した場合はその理由を示します。次は、ステータス・コードとその意味の一覧です。

rpc_ss_set_client_alloc_free は、この関数の例外復帰バージョンで、出力パラメータstatus を持ちません。このルーチンは次の例外を発生します。

マルチスレッドのアプリケーション中のスレッドは、TPINVALIDCONTEXT を含め、どのコンテキスト状態で実行していても、rpc_sm_set_client_alloc_free() または rpc_ss_set_client_alloc_free() の呼び出しを発行できます。

戻り値

なし

関連項目

『TxRPC を使用した BEA Tuxedo アプリケーションのプログラミング』