EssLROListObjects

指定したユーザー名または変更日(あるいはその両方)の、アクティブ・データベースのセルにリンクされているすべてのオブジェクトのリストを取得します。

構文

            ESS_FUNC_M EssLROListObjects (
            hCtx, userName, listDate, pulLROCount, pLRODescList)
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
userName	ESS_CHAR_T	ユーザー名。指定した場合は、指定したユーザーが最後に変更したすべてのオブジェクトのリストが戻されます。
listDate	ESS_TIME_T	変更日。指定した場合は、特定日以前に変更されたすべてのオブジェクトのリストが戻されます。時刻は1970年1月1日以降に経過した秒数をULONG値で示します。
pulLROCount	ESS_ULONG_T *	戻されるLROカタログ・エントリの数。
pLRODescList;	ESS_LRODESC_API_T	戻されるLROカタログ・エントリへのポインタのアドレス。

備考

userNameおよびlistDateパラメータの両方を指定した場合、両方の基準に合致するオブジェクトがリストされます。
呼出し元は、pLRODescListに割り当てられたメモリーの解放に責任を持ちます。

戻り値

正常終了の場合は、ESS_STS_NOERRが戻されます。それ以外の場合、エラー・コードが戻されます。

アクセス

この関数を呼び出すには、アクティブなデータベースに対して読取り権限(ESS_PRIV_READ)を持っている必要があります。

例

         ESS_FUNC_M ESS_LRO ListObjects (ESS_HCTX_T hCtx, ESS_HINST_T hInst)
{
        ESS_FUNC_M              sts = ESS_STS_NOERR;
        ESS_LRODESC_API_T       plroDescList=NULL;
        ESS_ULONG_T             ulLroCount;
        ESS_CHAR_T              userName[ESS_USERNAMELEN];
        ESS_CHAR_T              listDate[ESS_DATESIZE];
        ESS_CHAR_T              buf[ESS_DATESIZE];
        ESS_TIME_T              timestamp;
        struct tm               *pTmStruct, time_str;
        strcpy( userName, "user1");
        strcpy( listDate, "09/05/1997");
        
        time(&timestamp); 
        pTmStruct = localtime((ESS_PLONG_T)&timestamp);
        memset(&time_str, 0, sizeof(struct tm));
        strncpy (buf, (const char *)&listDate[8], 2);
        time_str.tm_year = atoi(buf);
        strncpy(buf, listDate, 2);
        time_str.tm_mon = atoi(buf)-1;
        strncpy(buf, (const char *)&listDate[3], 2);
        time_str.tm_mday = atoi(buf);
        time_str.tm_hour = 0;
        time_str.tm_min = 0;
        time_str.tm_sec = 1;
        time_str.tm_isdst = -1;
        if ((time_str.tm_mon != pTmStruct->tm_mon) ||
                (time_str.tm_year != pTmStruct->tm_year) ||
                (time_str.tm_mday != pTmStruct->tm_mday)) 
        {
                time_str.tm_mday++;
                timestamp = mktime(&time_str);
        }
        sts = EssLROListObjects(hCtx, userName, timestamp, &ulLroCount, &plroDescList);
        if(sts)
        {
                printf("Could not list linked objects. \n");
        }
        if (plroDescList)
                EssFree(hInst, plroDescList);   
        return sts;
}