[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETCPASS()
 Modifies or sets the password for a bindery object
------------------------------------------------------------------------------
 Syntax

     NNETCPASS(<cName>,[<nType>],<cOldPass>,<cNewPass>,
        [<cServer>|<nConId>]) --> lSuccess

     Netware: 2.2 and 3.11

 Arguments

     <cName>  Designates the name of the bindery object that is
     processed.

     <nType>  Designates a numeric value that indicates the type of
     <cName>.  The header file CTNNET.CH contains symbolic constants for the
     object types defined by Novell for use with the bindery functions of
     CA-Clipper Tools.  The default value indicates OBJ_USER.

     <cOldPass>  Designates the old password for <cName>.

     <cNewPass>  Designates the new password that is set for <cName>.

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

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

 Returns

     NNETCPASS() returns .T. if the new password has been set successfully.
     If an error occurs, the Novell error code can be queried with the
     NNETERROR() function.

 Description

     NOVELL NET CHANGE BINDERY OBJECT PASSWORD
     With NNETCPASS(), the password of a bindery object can be modified.
     Usually the function is used to change the password of a user.  The
     parameters <cName> and <nType> specify the object that is processed.  If
     the user does not have supervisor rights, the old password must be
     passed to prove the rights to set a new password.  If no password exists
     for <cName>, an empty string ("") must be passed for <cOldPass>.
     <cNewPass> is the new password that is set.  A user with supervisor
     rights can pass the parameter <cOldPass> as an empty string.

     With the parameters <cServer> or <nConId>, the bindery of any attached
     file server can be accessed.  The connection ID of a file server can be
     determined with NNETATTACH() or NNETLOGIN().

     Supervisor rights for the bindery are required to modify passwords.  For
     efficiency reasons, user defined object types must be passed in the high-
     low format.

 Notes

     .  The password of a bindery object does not affect the access
        possibilities to the object.  The password is only required when the
        object logs into the file server.

     .  When a password is first set, the object is required to have
        "password" property.  If necessary, the "password" property must be
        created with NNETCRTPRP().

 Example

     Change the password for user PAUL from LINDA to SILVIA:

     IF NNETCPASS('PAUL',,'LINDA','SILVIA')
     ? 'Password changed!'
     ELSE
     ? 'Password not changed!'
     ENDIF

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