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.