EssListConnections

現在ログインしているサーバーまたはアプリケーションに接続されているユーザーをすべてリストします。

構文

            ESS_FUNC_M EssListConnections (
            hCtx, pCount, ppUserList
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
pCount	ESS_PUSHORT_T	ユーザーのカウントを受け取る変数。
ppUserList	ESS_USERINFO_T, ESS_GROUPINFO_T	ユーザー情報構造体の配列へのポインタ。この配列はAPIによって割り当てられます。

備考

pCountには、ppUserList配列内の要素の数が含まれます。
hCtxがスーパーバイザの場合、ppUserListはサーバーにログインしているユーザーのリストになります。hCtxがアプリケーション・デザイナの場合、ppUserListはhCtxがアプリケーション・デザイナになっているアプリケーションに接続しているユーザーのリストになります。
ppUserListに割り当てられたバッファを解放するには、EssFreeを使用します。

戻り値

成功の場合、0が戻されます。

アクセス

この関数を使用するには、呼出し元がスーパーバイザまたはアプリケーション・デザイナ権限を持っている必要があります。

例

         ESS_FUNC_M ESS_ListUserConnections (ESS_HCTX_T        hCtx, ESS_HINST_T hInst)
{
        ESS_FUNC_M         sts = ESS_STS_NOERR;
        ESS_USHORT_T      usrcnt;
        ESS_PUSERINFO_T   users;
        sts = EssListConnections(hCtx, &usrcnt,     &users);
        if(!sts)
        EssFree(hInst, users);
        return(sts);
}