[<<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