EssAddToGroupEx

指定したグループにユーザーを追加します。EssAddToGroupに似ていますが、ユーザー・ディレクトリの指定、またはGroupIdやUserIdの一意のID属性を受け入れることができます。

構文

            ESS_FUNC_M EssAddToGroupEx (
            hCtx
            , 
            GroupId
            , 
            UserId
            , 
            bUsingIdentity
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル(入力)。
GroupId	ESS_STR_T	グループ名またはID (入力)。groupname@providerまたは一意のID属性として指定できます。
bIsGroupId	ESS_BOOL_T	入力。GroupIdが名前かIDかを示します。TRUEの場合、GroupIdはIDです。
UserId	ESS_STR_T	グループに追加するユーザー名(入力)。username@providerまたは一意のID属性として指定できます。
bUsingIdentity	ESS_BOOL_T	入力。UserIDが名前かIDかを示します。TRUEの場合、UserIDはIDです。

備考

APIはIDまたはグループ名を受け入れることができます。グループ名はgroupname@providerとして指定できます。

戻り値

なし。

アクセス

この関数を使用するには、ログインしたサーバーに対して、呼出し元がユーザーの作成/削除権限(ESS_PRIV_USERCREATE)を持っている必要があります。

例

         

void DisplayUserList(ESS_USHORT_T count, ESS_PSTR_T UserList)
{
	ESS_USHORT_T i;

	for (i = 0; i < count; i++)
	{   
		if (UserList [i]) 
			printf ("%s\n", UserList[i]);
	}
}

ESS_FUNC_M ESS_AddUser (ESS_HCTX_T    hCtx)
{
   ESS_STS_T sts  = ESS_STS_NOERR;
   ESS_STR_T groupId, userId;
   ESS_BOOL_T bGroupId, bUserId;
   ESS_BOOL_T bisIdentity;
   ESS_USHORT_T type;
   ESS_USHORT_T count;
   ESS_BOOL_T bUsingIdentity;
   ESS_PSTR_T pUserList;
   
   groupId = "IDRegularGroup@ldap";
   bGroupId = ESS_FALSE;
   userId = "IDUser6";
   bUserId = ESS_FALSE;
   sts = EssAddToGroupEx(hCtx, groupId, bGroupId, userId, bUserId);
   printf("EssAddToGroupEx sts: %ld\n", sts);
   if(!sts)
   {
      sts = EssGetGroupListEx(hCtx, groupId, bisIdentity, type, &count, &bUsingIdentity, &pUserList);
      printf("EssGetGroupListEx sts: %ld\n", sts);
      if(!sts)
      {
         if(pUserList)
         {
            printf ("\n---User/Group list for %s:\n", groupId);      
            DisplayUserList(count, pUserList);
         }
         else
            printf ("\tUser list is empty\n");
      }
   }
      
   return (sts);
}