[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETCLRCON()
 Clears a connection number
------------------------------------------------------------------------------
 Syntax

     NNETCLRCON(<nConnect>,[<cServer>|<nConId>])
         --> lSuccess

     Netware: 2.2 and 3.11

 Arguments

     <nConnect> Designates the connection number that is cleared.

     <cServer> Designates the name of the file server that is used.  Your
     workstation must be attached to <cServer>.

     <nConId> Designates the connection ID of your workstation on
     <cServer>.

 Returns

     NNETCLRCON() returns .T. if <nConnect> has been cleared successfully.
     If an error occurs, the function returns .F..

 Description

     NOVELL NET CLEAR CONNECTION
     When a workstation is first attached to a server, the Netware file
     server returns a connection number (connection ID) to the workstation.
     The file server keeps the connection ID even after a logout and is
     assigned to the related workstation at the next connection setup.
     However, the connection ID is changed, if all connection numbers are
     used.  In this case, the connection ID can be assigned to another
     workstation. NNETCLRCON() allows you to clear used connection numbers.

     Important!  If the connection <nConnect> is currently active, it is
     interrupted immediately.  This can lead to data loss on the related
     workstation, as all drive mappings become invalid and the writing of
     data to the server is no longer possible.

     Supervisor rights on the related file server are required to clear a
     connection.

 Note

     .  This function should be used very carefully as data loss is
        possible if <nConnect> is currently active.

 Example

     Determine the connection ID of the user MICK, and clear the connection
     (ATTENTION: MICK will be logged out):

     NNETCLRCON(NNETSTANUM('MICK'))

See Also: NNETSTANUM()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson