edmiRemoteCreateGroup

EdmiError edmiRemoteCreateGroup(SdaiServerContext serverContextId,
                                  SdaiString        groupName,
                                  SdaiGroup         *groupId, 
                                  SdaiInvocationId  *edmiInvocationId);

Creates a new EDMgroup in a remote EDMdatabase. EDMgroup names must be unique within an EDMdatabase. It may consist of letters, digits and hyphens. The first character must be a letter. EDMgroup names are case insensitive. The edmiRemoteCreateDatabase function will implicitly create the EDMgroup named 'sdai-group' and the EDMusers 'superuser' and 'sdai-user'. The two users will be members of 'sdai-group'. Only the superuser may use this function.

Arguments

1	Type	Name	Comment
2	SdaiServerContext	serverContextId	Context identification, from edmiDefineServerContext
3	SdaiString	groupName	The name of the EDMgroup to create in the remote EDMdatabase. EDMgroup names are case insensitive.
4	SdaiGroup	groupId	A variable that will receive the numeric groupId that uniquely identifies the EDMgroup in the EDMdatabase.
5	SdaiInvocationId	edmiInvocationId	Currently not used.

Return Value

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_EDMInterface'.

Options

Option	Comment
Option name	Comment

Example

 EdmiError rstat;
 SdaiServerContext suContext;
 SdaiUser userId;
 SdaiGroup groupId;
  
 /* Define Remote Server Context
 for the superuser */ 
 rstat = edmiDefineServerContext("SuperUserContext",
 "superuser", NULL, "dbName", 
 "TCP", "9090", "MyServerHost", 
 NULL, NULL, NULL, NULL, NULL, &suContext); 
  
 /* First, change the superuser password
 from the factory setting <databaseName> 
 to the somewhat more complicated 'xfx56kl9' */ 
 rstat = edmiRemoteDefinePassword(suContext, "xfx56kl9", NULL);
  
 /* The new password makes the current context obsolete. */
 rstat = edmiDeleteServerContext(suContext);
  
 /* A new context must be created
 to reflect the change in password */ 
 rstat = edmiDefineServerContext("SuperUserContext",
 "superuser", NULL, "xfx56kl9",
 "TCP", "9090", "MyServerHost",
 NULL, NULL, NULL, NULL, NULL, &suContext); 
  
 /* Check if 'Lucy' exists as user */
 rstat = edmiRemoteGetUser(suContext, "Lucy", &userId, NULL);
 if (rstat = edmiENOUSER) {
 rstat = edmiRemoteCreateUser(suContext, "Lucy", &userId, NULL); 
 }
  
 /* Check if 'Guest' exists as user */
 rstat = edmiRemoteGetGroup(suContext, "Guest", &groupId, NULL);
 if (rstat = edmiENOGROUP) {
 rstat = edmiRemoteCreateGroup(suContext, "Guest", &groupId, NULL); 
 }
  
 /* Put 'Lucy' in the 'Guest' group */
 rstat = edmiRemoteUserToGroup(suContext, groupId, userId, NULL);
  
 /* Change Lucys password from the
 default 'Lucy' to 'ddf54y' */ 
 rstat = edmiRemoteChangePassword(suContext, userId, "ddf54y", NULL);
 . . .

edmiRemoteCreateGroup

Arguments

Return Value

Options

Example

See also

Filter by label