[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETPWGRCE()
 Sets or queries the number of grace logins
------------------------------------------------------------------------------
 Syntax

     NNETPWGRCE(<cUser>,[<nNumber>],[<lMode>],[<cServer>|
        <nConId>) --> nNumber

     Netware: 2.2 and 3.11

 Arguments

     <cUser>  Designates the name of the user whose number of grace
     logins is set or determined.

     <nNumber>  Designates the new number of grace logins for <cUser>.
     The number of remaining grace logins or the maximum number of grace
     logins is set depending on the parameter <lMode>.

     <lMode>  Designates if the number of remaining grace logins (.F.) or
     the maximum number of grace logins (.T.) is set.  The default value is
     .F..

     <cServer>  Designates the name of the file server to which <cUser>
     has access.  Your workstation must be attached to <cServer>.

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

 Returns

     NNETPWGRCE() returns the currently valid number of grace logins for
     <cUser>.  Dependent on the parameter <lMode>, the return value contains
     the number of remaining grace logins (<lMode>=.F.) or the maximum number
     of grace logins (<lMode>=.T.).  If a value has been passed for <nNumber>
     and the return value does not match <nNumber>, the requesting user did
     not have the rights for the modification.

 Description

     NOVELL NET PASSWORD GRACE LOGINS
     NNETPWGRCE() indicates the number times a user can log in with an
     expired password.  With each login under an expired password, Netware
     reduces the number of remaining logins by 1.  However, the maximum
     number of grace logins remains unchanged.

     NNETPWGRCE() allows you to set or determine the number of remaining
     grace logins or the maximum number of grace logins for <cUser>. If the
     parameter <lMode> is not passed or is passed with .F.,  NNETPWGRCE()
     returns the number of remaining grace logins.  If the <lMode> paramter
     is passed with .T., the maximum number of grace logins can be set or
     determined.  To query the number of grace logins, do not pass a value
     for <nNumber>.  If <nNumber> contains a numeric value, NNETPWGRCE()
     tries to set this value as new number of grace logins.  Supervisor
     rights on the related file server are required to modify the number of
     grace logins.  With the parameters <cServer> or <nConId>, the number of
     grace logins for users on any attached file server can be changed.  The
     connection ID of a file server is returned by NNETATTACH() or
     NNETLOGIN().

 Examples

     .  Determine the number of remaining grace logins for user MIKE:

        ? NNETPWGRCE('MIKE')              // For example 4

     .  Determine the maximum number of grace logins for user MIKE:

        ? NNETPWGRCE('MIKE',,.T.)         // For example 6

     .  Set the new maximum number of grace logins for user MIKE:

        NNETPWLEN('MIKE',8,.T.)

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