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