beginOnlineLogin

Typically, the generated package database class already has a valid synchronization connection profile and you can log in to the Unwired Server with your username and credentials.

beginOnlineLogin sends a message to the Unwired Server with the username and password. The Unwired Server responds with a message to the client with the login success or failure. This method checks the SUPApplication connectionStatus and immediately fails if the status is not SUPConnectionStatus_CONNECTED. Make sure the connection is active before calling beginOnlineLogin, or implement the onLoginFailure callback handler to catch cases where it may fail, otherwise an exception may be thrown.

When the login succeeds, the onLoginSuccess method of the CallbackHandler is invoked. When the login fails, the onLoginFailure method of the CallbackHandler is invoked.

Syntax

+ (void)beginOnlineLogin:(NSString *)user password:(NSString *)pass

Parameters

• userName – the user name.
• password – the password.

Returns

None.

Examples

• Begin an Online Login – Start logging in with "supAdminID" for the user name and "supPass" for the password.

  [SUP101_SUP101DB beginOnlineLogin:@"supAdminID"
  password:@"supPwd"];