gpwAuthLogin (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / User Groupware functions

Handling errors
Application in the background: Specific case from Android 10

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

gpwAuthLogin (Function)

In french: gpwAuthLogin

Allows you to log in to the User Groupware using an account such as Facebook, Google, Microsoft, etc.

Example

Identité is OpenIDIdentity = gpwAuthLogin(gpwFacebook)

arrOAuthParam is array of gpwOAuthParameters
arrOAuthParam = gpwListOAuthParameters()
IF ErrorOccurred THEN
	Error(ErrorInfo())
	RETURN
END

Parameters is gpwOAuthParameters = arrOAuthParam[1]
sCode is string = gpwAuthLogin(Parameters)
IF ErrorOccurred THEN
	Error(ErrorInfo())
	RETURN
END

User is gpwUser
sToken is string
(sToken, User) = gpwRemoteConnect(Parameters, sCode)
IF ErrorOccurred THEN
	Error(ErrorInfo())
	RETURN
END

Syntax

<Result> = gpwAuthLogin(<Type> [, <Index>])

<Result>: OpenIDIdentity variable

OpenIDIdentity variable that contains the user information.

<Type>: Integer constant

Type of login that allows for authentication:
gpwConnection Standard login with a user that has been created and registered.
gpwFacebook Login with a Facebook account.
gpwGoogle Login with a Google account.
gpwMicrosoft Login with a Microsoft MSN account.
gpwSalesforce Login with a Salesforce account.
gpwYahoo Login with a Yahoo account.

<Index>: Optional integer

Index of the custom connection when adding it with gpwAddAuthLogin. To use this parameter, <Type> must correspond to the gpwConnection constant.
Note: Connection information has been described and added using the gpwAddAuthLogin function.

<Result> = gpwAuthLogin(<Parameter>)

<Result>: Buffer

User identification code to use with gpwRemoteConnect.

<Parameter>: gpwOAuthParameters variable

Name of the gpwOAuthParameters variable that contains the characteristics of the OAuth application to use for authentication.

Remarks

Handling errors

If a login error occurs, the ErrorOccurred variable is set to True. The error can be identified using ErrorInfo.

Application in the background: Specific case from Android 10

Starting with Android 10, it is no longer possible to open a window when the application is in the background.

gpwAuthLogin can open a window. If this function is used while the application is in the background, a fatal error will occur.

Tips:

It is possible to determine if the application is in the background using InBackgroundMode.
If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.

For more details, see Android 10: Behavior of applications in the background.

Business / UI classification: Neutral code

Component: wd300gpu.dll