EssListSSMigrFailedUsers

Displays users that did not successfully migrate to Shared Services.

Syntax

ESS_FUNC_M EssListSSMigrFailedUsers (hCtx,  count, pNativeUserList);
ParameterData TypeDescription

hCtx

ESS_HCTX_T

API context handle.

count

ESS_PUSHORT_T

Address of variable to receive count of migration failed users.

pNativeUserList

ESS_PPUSERNAME_T

Address of pointer to receive an allocated array of migration failed users.

Return Value

Returns 0 if successful; otherwise, returns an error.

Example

ESS_FUNC_M ESS_SS_ListSSMigrFailedUsers(ESS_HCTX_T  hCtx, ESS_HINST_T hInst)
{
   ESS_STS_T         sts = ESS_STS_NOERR;
   ESS_PUSERNAME_T   pNativeUserList = NULL;
   ESS_USHORT_T      Count = 0,
                     index;
   
   sts = EssListSSMigrFailedUsers(hCtx, &Count, &pNativeUserList);

   if (!sts)
   {
      if (Count && pNativeUserList)
      {
         printf ("\n------- User List -------\n\n");

         for (index = 0; index < Count; index++)
         {
            if (pNativeUserList[index])
               printf ("%s\n", pNativeUserList[index]);
         }

         EssFree(hInst, pNativeUserList);
      }
      else
         printf("\nUser list is empty\n\n");
   }
   else
      printf("Failed to get Shared Services migration failed Users list.\n");

   return (sts);   
}

See also an extended Shared Services Migration and User Management API Example

See Also

  • EssListSSMigrFailedGroups