NWDSVerifyObjectPassword(3nw)
NWDSVerifyObjectPassword --
verifies the password of an object
Synopsis
#include <nwnet.h>
or
#include <nwdsasa.h>
NWDSCCODE N_API NWDSVerifyObjectPassword
(NWDSContextHandle contextHandle,
nflag32 optionsFlag,
pnstr8 objectName,
pnstr8 password);
Description
The parameters are as follows:
- contextHandle
-
(IN) Specifies the handle to the name context structure.
- optionsFlag
-
(IN) Reserved; pass in zero.
- objectName
-
(IN) Points to the object name (under the context) of the object to verify.
- password
-
(IN) Points to the clear-text password for the object.
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
To call NWDSVerifyObjectPassword successfully, the current password of the object must be known. If no such password exists, password should point to a
zero-length string. All strings used by NWDSVerifyObjectPassword are
NULL-terminated. password can be any length and all
characters are significant. Upper- and lowercase letters are distinct.
The password does not appear on the wire in NWDSVerifyObjectPassword. It is used to decrypt the private key attribute of the object. password is overwritten
by NWDSVerifyObjectPassword to prevent compromising it locally. If an application has copied the password, it should destroy (overwrite) any copies as soon as possible.
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),
NWDSLogin(3nw),
NWDSChangeObjectPassword(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.