AuthentiX Extensibility SDK

AuthText

The AuthText method is called by AuthentiX when the Get Text from COM Component is set.
AuthText should return the message to be sent to the browser on Access Denied.

Visual C++ Syntax

BSTR CAuthCOMCtrl::AuthText(

BSTR FAR* username, BSTR FAR* password, BSTR FAR* referer, BSTR FAR* remote_addr, BSTR FAR* authorizingPath, BSTR FAR* accessingPath, BSTR FAR* servername, BSTR FAR* userString, short errorCode);

Visual Basic Syntax

Public Function AuthText(

username As String, _ password As String, _ referrer As String, _ remote_addr As String, _ authorizingPath As String, _ accessingPath As String, _ servername As String, _ userString As String, _ errorCode As Integer) _ As String

Parameters

username

The username the website visitor has supplied.

password

The password the website visitor has supplied.

referrer

The referring URL that brought the visitor to the requested page.

remote_addr

The IP Address from which the visitor is making the request.

authorizingPath

The directory being protected

accessingPath

The path on which access is being attempted

userString

Not used.

errorCode

One of:

#define AUTHX_DENIED_EMPTY -2
#define AUTHX_DENIED_UNKNOWN_USER -3
#define AUTHX_DENIED_BAD_PASSWORD -6
#define AUTHX_DENIED_REFERRAL_BLOCK -4
#define AUTHX_DENIED_MULTI_BLOCKED -5
#define AUTHX_DENIED_EXPIRED -7
#define AUTHX_DENIED_ODBC_EXPIRED -9
#define AUTHX_DENIED_COOKIE_TIMED_OUT -10
#define AUTHX_DENIED_IP_BLOCK -11
#define AUTHX_DENIED_KBYTES -12
#define AUTHX_DENIED_REQUESTS -13
#define AUTHX_DENIED_SEQ_LOGINS -14
#define AUTHX_DENIED_FOOTPRINT -15
#define AUTHX_DENIED_DN_BLOCK -16
#define AUTHX_DENIED_UA_BLOCK -17
#define AUTHX_DENIED_DAP -18
#define AUTHX_DENIED_TIMED_OUT -19

Return Values

The string to be supplied Example

Example projects for VC++ and VB are included with the product in the installation directory. See the /ByCOM/AuthCOM directory.

For reference and more detailed instructions on how to work with AuthentiX and COM components, please

see Tutorial and where to set this up.