名前

rpc_sm_client_free()、rpc_ss_client_free()−クライアント・スタブから返されたメモリの解放

形式

#include <rpc/rpc.h> 
void rpc_sm_client_free (idl_void_p_t node_to_free, unsigned32 *status)
void rpc_ss_client_free (idl_void_p_t node_to_free)

機能説明

ルーチン rpc_sm_client_free() は、クライアント・スタブに割り当てられ、そのスタブから返されたメモリを解放します。入力パラメータ node_to_free は、クライアント・スタブから返されたメモリを指すポインタを指定します。ISO 標準の C 環境では、idl_void_p_t は void * と定義され、他の環境では char * と定義されます。

このルーチンにより、他のルーチンはそれが呼び出されたメモリ管理環境を意識せずに、RPC コールにより返された動的に割り当てられたメモリを解放することができます。

コードがサーバの一部として実行している場合であっても、このルーチンは常にクライアント・コードから呼び出されます。

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

rpc_ss_client_free() は、この関数の例外復帰バージョンであり、出力パラメータ status を持ちません。例外は発生しません。

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

戻り値

なし

関連項目

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