[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETADR()
 Determines the internal netaddress of a user
------------------------------------------------------------------------------
 Syntax

     NNETADR([<cUser>],[<nNumber>],[<cServer>|<nConId>])
         --> cNetAddress

     Netware: 2.2 and 3.11

 Arguments

     <cUser>  Designates the login name of the user whose internal
     netaddress is determined.  The default value is the internal netaddress
     of the current workstation.

     <nNumber>  Designates the connection of <cUser>.  The default value
     is 1.

     <cServer>  Designates the name of the file server on which <cUser>
     is logged in.  Your workstation must be attached to <cServer>.

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

 Returns

     NNETADR() returns the internal netaddress of <cUser> in the form of a 20-
     character hexadecimal string.  The returned string represents a
     10-byte sequence, where each byte consists of two hexadecimal
     characters.  The leading eight characters of <cNetAddress> (four byte)
     specify the network number of <cUser>.  The remaining 12 characters (six
     byte) contain the station ID of <cUser> (number of the network adapter,
     Node Address).

     If an error occurs (no user is logged in with the name <cUser>),
     NNETADR() returns an empty string.

 Description

     NOVELL NET ADDRESS
     NNETADR() allows you to determine the internal netaddress of the
     workstation, where <cUser> is currently logged in.  For example, this
     address can be used to establish a Point-To-Point connection with
     <cUser>.

     Netware does not limit the number of workstations where a user can be
     simultaneously logged in.  The currently active connections can be
     passed with the optional parameter <nNumber>.  The default return value
     of NNETADR() contains the internal netaddress of the first connection.
     By passing <nNumber>, additional addresses can be determined.

 Note

     .  <nNumber> does not specify the connection ID of <cServer>.
        This parameter simply counts the connections of <cUser>.

 Examples

     .  Determine the internal netaddress of the first connection of
        user MIKE:

        ? NNETADR('MIKE')  // z.B. "4921750400001B025A99"

     .  Determine the internal netaddresses of all connections of user
        MIKE:

        nNumber=1
        cAdr=""
        WHILE .T.
        cAdr=NNETADR('MIKE',nNumber)
        IF EMPTY(cAdr)
        EXIT
        ENDIF
        ? cAdr
        nNumber=nNumber+1
        ENDDO

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