Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Novlib 3.30 Online Reference - <b> wsconclr()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 WSConClr()
------------------------------------------------------------------------------
 Warning:
 USE WITH EXTREME CAUTION.

 Clearing a connection while it has open files can corrupt those data files.

 Purpose:
 Clear a workstation connection from a file server.

 Syntax:
 bResult = WSConClr( iConnNum )

 Parameters:
 iConnNum The connection number to clear.

 Returns:
 A boolean value (TRUE or FALSE).

 Description:
 Returns TRUE if the specified connection number was cleared
 successfully. Returns FALSE if not, or if an error occurs.

 If a user is logged in when their connection number is cleared, the user is
 logged out and their open files are closed without changes necessarily
 being written to disk.

 Example:
 // To clear connection number 15:
 if ( WSConClr( 15 ) )
    ? "Connection 15 is now cleared"
 endif

 Notes:
 This function requires that the requesting user is logged in as
 Supervisor or is security equivalent to Supervisor or has console operator
 status.

 If FALSE is returned, check NWErrorGet().

See Also: WSConNumGet() UsrConLst() FSCurConGet()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson