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.