registerUser:password:error:isSyncFlag: method

Registers the client with the server by automatically creating a user with the help of a pre-defined authentication mechanism.

Syntax

- ( BOOL ) registerUser : ( NSString * ) userName password : ( NSString * ) loginPassword error : ( NSError ** ) error isSyncFlag : ( BOOL ) isSynchronous

Parameters

userName – User Name that will be authorised by a predefined security provider
loginPassword – Password for that user
error – A double pointer to the error object that the application will pass to the function call and which will be populated by the function call in case of any errors within.
isSynchronous – A flag indicating whether the user registration has to happen synchronously or in an asynchronous manner

Returns

Returns a BOOL indicating if the user registration has been successful. Significant in case of synchronous registration only.

Example 1

Synchronous Registration 
SMPUserManager* userManager = [SMPUserManager initializeWithConnection:clientConn];
NSError* error = nil;
if([userManager registerUser:"username" password:@"password" error:&error isSyncFlag:YES])
{
    // Further processing
} else
{
    // Error handling using the error object defined above
}



Asynchronous Registration 
SMPUserManager* userManager = [SMPUserManager initializeWithConnection:clientConn];
NSError* error = nil;
[SMPUserManager setDelegate:self]; // The class implementing the listener methods should adhere to <SMPUserManagerDelegate> protocol
[userManager registerUser:"username" password:@"password" error:&error isSyncFlag:NO];