52.3 Authentication Function (NWAPPAuthenticateExtern)

The NWAPPAuthenticateExtern function provides an external authentication hook into the zenlite.dll library.

52.3.1 Syntax

#include <afxwin.h>
 
bool __stdcall NWAPPAuthenticateExtern 
{  
   char        *szTreeName, 
   char        *DSName, 
   char         szWho
} 

52.3.2 Parameters

szTreeName

(IN) Points to the name of the directory tree where the DLL is located on the client.

DSName

(IN) Points to the name of the application object provided to the user. For example, this application can request name and/or password or some other authentication method like a thumbprint for a biometric scanner.

szWho

(IN) Specifies the fully qualified user name.

52.3.3 Return Values

TRUE

Launch the application.

FALSE

Do not launch the application.

52.3.4 Remarks

The implementation of this function is left up to you. Values passed to NWAPPAuthenticateExtern that exceed MAX_DN_BYTES bytes (MAX_DN_BYTES = 512) overflow the buffer and return an access violation.

IMPORTANT:Make certain you export the function.