Oracle TimesTen In-Memory Database C開発者およびリファレンス・ガイド

ttUtilGetErrorCount

説明

TimesTenユーティリティ・ライブラリ関数（ttUtilAllocEnvおよびttUtilFreeEnvを除く）への最後のコールによって生成されたエラーまたは警告（あるいはその両方）の数を取得します。これらの各関数は、アプリケーションからの1回のコールで、複数のエラーまたは警告（あるいはその両方）を生成する可能性があります。これらのエラーまたは警告（あるいはその両方）のすべてを取得するには、TTUTIL_NODATAが返されるまで、アプリケーションでttUtilGetErrorをコールする必要があります。

構文

ttUtilGetErrorCount (ttUtilHandle handle,

unsigned int *errCount);

パラメータ

ttUtilGetErrorCount には、次のパラメータがあります。


パラメータ	型	説明
handle	ttUtilHandle	ttUtilAllocEnvを使用して割り当てられるTimesTenユーティリティ・ライブラリ環境ハンドルを指定します。
errCount	unsigned int *	TimesTenユーティリティ・ライブラリへの最後のコール（ttUtilAllocEnvとttUtilFreeEnvを除く）によって生成されたエラーまたは警告（あるいはその両方）の数を示します。

リターン・コード

ttUtilGetErrorCountCountは、次のコード（ttutillib.hで定義されています）を返します。


コード	説明
TTUTIL_SUCCESS	成功時に返します。
TTUTIL_INVALID_HANDLE	無効なユーティリティ・ライブラリ・ハンドルが指定されている場合に返します。

例

payrollというDSNに対してttDestroyDataStoreをコールした後に、エラーおよび警告のカウント情報を取得するには、次のように入力します。

int rc;

unsigned int errCount;

ttUtilHandle utilHandle;

rc = ttDestroyDataStore (utilHandle, "DSN=payroll", 30);

if (rc == TTUTIL_SUCCESS)
printf ("Datastore payroll successfully destroyed.\n")

else if (rc == TTUTIL_INVALID_HANDLE)
printf ("TimesTen utility library handle is invalid.\n");

else

{

rc = ttUtilGetErrorCount(utilHandle, &errCount);

...............

}

注意

各TimesTenユーティリティ・ライブラリ関数は、アプリケーションからの1回のコールで、複数のエラーおよび警告を生成する可能性があります。これらのエラーおよび警告のすべてを取得するには、TTUTIL_NODATAが返されるまで、アプリケーションでttUtilGetErrorを繰り返しコールする必要があります。

参照

ttUtilAllocEnv
ttUtilFreeEnv
ttUtilGetError