NWDSChangeObjectPassword(3nw)


NWDSChangeObjectPassword -- changes the authentication password for a Directory object

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdsasa.h> 
   

NWDSCCODE N_API NWDSChangeObjectPassword (NWDSContextHandle context, nflag32 optionsFlag, pnstr8 objectName, pnstr8 oldPassword, pnstr8 newPassword);

Description

The parameters are as follows:

context
(IN) Specifies the Directory context for the request.

optionsFlag
(IN) Reserved; pass in zero.

objectName
(IN) Points to the object name whose password is to be changed.

oldPassword
(IN) Points to the object's current password.

newPassword
(IN) Points to the object's new password.

Return values

0x0000
SUCCESSFUL

Negative Value
Negative values indicate errors. For errors returned by Directory Services, see ``Directory Services OS Errors'' (-001 to -255), ``Directory Services Client Library Errors'' (-301 to -399), or ``Directory Services Agent in the Server Errors'' (-601 to -699).

Notices

For NWDSChangeObjectPassword to succeed, oldPassword must be correct. If no value is currently assigned to the password, oldPassword should point to a zero-length string.

If no new password value is desired, newPassword should point to a zero-length string.

A password can be any length and all characters are significant. Uppercase and lowercase characters are distinct.

If an application has a local copy of any password value, the value should be erased as soon as possible to prevent compromising the security of the password.

After a user object is created, NWDSGenerateObjectKeyPair must be called for NWDSChangeObjectPassword to succeed.

Services

Directory

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 22 Get Station's Logged Info (old)
0x2222 23 28 Get Station's Logged Info
0x2222 104 01 Ping for NDS NCP
0x2222 104 02 Send NDS Fragmented Request/Reply

References

NWDSGenerateObjectKeyPair(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.