形式
#include <sys/_Elmarm4.h>
arm_error_t arm_blocked(
/* [in] */ arm_start_handle_t start_handle,
/* [in] */ arm_int32_t flags,
/* [in] */ arm_buffer4_t *buffer4,
/* [out] */ arm_block_handle_t *block_handle
);
機能説明
arm_blocked() は、別のアプリケーション内のトランザクションが完了するのを
待ってトランザクションの処理がブロックされていることを示すために使用します。
これは、そのアプリケーション内でトランザクションのどの部分の応答時間が消費
されているかと、ダウンストリーム・アプリケーションの中でどの部分が消費されてい
るかを識別するのに役立ちます。
- start_handle
- このトランザクションに対する arm_start_transaction() から戻された
ハンドル。
- flags
- 今後の使用のため予約されています。引数は 0 に設定する必要があります。
- buffer4
- 追加データが入っている 1 つ以上のサブバッファーを識別するバッファーへのポインター。
現在は、この関数にサブバッファーは定義されていないので、NULL ポインターを渡
してください。
バッファーが渡されても、eWLM はそれを無視します。
- block_handle
- arm_blocked() 呼び出しを識別するハンドルが戻される 64 ビット域へのポ
インター。
このハンドルは arm_unblocked() に渡す必要があります。
このハンドルは、呼び出し元のプロセス内でのみ有効です。
戻り値
正常に実行されると、arm_blocked は ARM_RC_SUCCESS を戻します。
失敗した場合、エラーを示す errno と戻りコードが設定されます。考えられるすべての戻りコードのリストについては、
戻りコードを参照してください。失敗すると、block_handle は、後で他のインターフェースの呼び出しに使用でき
るダミー値に設定されます。
このようなインターフェースは、block_handle にはダミー値が入っていることを認識し、何も処理を実行せずに戻ります。
- エラー・コード
- 説明
- EFAULT
- このサービスのパラメーターに、呼び出し元がアクセスできないアドレスが
入っていました。
- EINVAL
- このサービスのパラメーターに、無効な値が入っていました。
- EMVSARMERROR
- ARM エラーが発生しました。
具体的なエラーの戻りコードを参照してください。
- EPERM
- 呼び出し元に適切な特権がありません。戻りコードは ARM_RC_AUTH_ERROR に設定されます。
- EMVSSAF2ERR
- セキュリティー・プロダクトでエラーが発生しました。