NWDSGenerateObjectKeyPair

Creates or changes a public/private key pair for a specified object. Does not support international or extended characters in passwords.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP
Library:Cross-Platform NDS (NET*.*)
Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsasa.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSGenerateObjectKeyPair  ( 
     NWDSContextHandle   contextHandle,  
     pnstr8              objectName,  
     pnstr8              objectPassword,  
     nflag32             pwdOption);

Pascal

  uses netwin32 
   
  Function NWDSGenerateObjectKeyPair 
    (contextHandle : NWDSContextHandle; 
     objectName : pnstr8; 
     objectPassword : pnstr8; 
     pwdOption : nflag32 
  ) : NWDSCCODE;

Parameters

contextHandle

(IN) Specifies the NDS context for the request.

objectName

(IN) Points to the name of the object to update.

objectPassword

(IN) Points to the object password in ASCII text format.

pwdOption

(IN) Specifies the password to operate on. Select from the following:

Value

Constant

Description

0

ALL_PASSWORDS

All passwords are changed.

1

NDS_PASSWORD

Only the eDirectory password is changed.

2

NT_PASSWORD

Only the NT password is changed (the NT password that NDS4NT in eDirectory).

4

AD_PASSWORD

Only the AD/NT password (serviced by password sync).

Return Values

0x0000 0000

SUCCESSFUL

nonzero value

Nonzero values indicate errors. See NDS Return Values.

Remarks

If no password is desired, objectPassword should point to a zero-length string ("").

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.

An object must have rights to modify an object's password attributes before the NWDSGenerateObjectKeyPair function will succeed.

The NT_PASSWORD option only works if the eDirectory for NT product has been installed. If this flag is passed in as the value for the pwdOption parameter and the eDirectory for NT product has not been installed, an error is returned.

If the ALL_PASSWORDS option is set, the NDS_PASSWORD operation is performed first. If successful, other password operations are attempted, but error conditions are not returned for the other operations.

IMPORTANT:NWDSGenerateKeyPairEx supports international and extended characters in passwords and is recommended in place of NWDSGenerateObjectKeyPair.

NCP Calls

See Also

NWDSChangeObjectPassword