機能
連結機能を使用するためのハンドルを取得します。
記述形式
#include "libAsis.h" /* 公開ヘッダ */
int AsisAllocHandleReplace(
ASISHANDLE *RHandle, /* ハンドル */
char *LogFile); /* ログファイル */ |
パラメタ
データ型 | パラメタ | 用途 | 説明 |
|---|---|---|---|
ASISHANDLE* | RHandle | 出力 | 割り当てるハンドルを返却する領域を指定します。 |
char* | LogFile | 入力 | ログファイルを指定します。 |
復帰値
復帰値 | 説明 |
|---|---|
ASIS_SUCCESS | 関数が正常に終了したことを示します。 |
ASIS_ERROR | 関数の実行時に問題が検出されたことを示します。 |
関数の利用規則
LogFileパラメタに指定されたログファイルに誤りがある場合、本関数は復帰値ASIS_ERRORで異常終了し、エラーレベル「警告」が設定されます。この場合、動作ログは採取されませんが、処理を継続できます。
本関数の復帰値がASIS_ERRORの場合でも、RHandleパラメタに指定したハンドルがNULL以外の場合は、AsisFreeHandleReplace関数を呼び出し、ハンドルに関連付けられたメモリ上の作業領域を解放する必要があります。
