com.HTTPRequest.clearAuthentication

Removes user-defined authentication.

Syntax

clearAuthentication()

Usage

Removes user-defined authentication.

If an authenticate entry exists in the FGLPROFILE file, it will be used for authentication, even if the user-defined authentication was removed.

Important: The iOS HTTP stack doesn't provide a simple way to handle authentication. The GMI front-end uses the global iOS credential management system, that keeps credential values of previous request based on host and realm, until the keep-alive session is closed. Therefore, doing a clearAuthentication() on iOS devices does not take effect immediately.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).