NWChangeObjectPassword

Changes the specified password of an object to a new password

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Bindery

Syntax

C

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API  NWChangeObjectPassword  ( 
      NWCONN_HANDLE       conn,  
      const nstr8 N_FAR  *objName,  
      nuint16             objType,  
      const nstr8 N_FAR  *oldPassword,  
      const nstr8 N_FAR  *newPassword);
   

Pascal

   uses calwin32 
    
   Function NWChangeObjectPassword 
     (conn : NWCONN_HANDLE; 
      const objName : pnstr8; 
      objType : nuint16; 
      const oldPassword : pnstr8; 
      const newPassword : pnstr8 
   ) : NWCCODE; stdcall;
   

Parameters

conn
(IN) Specifies the NetWare server connection handle corresponding to the server to receive the change.
objName
(IN) Points to the name of the object whose password is to be changed.
objType
(IN) Specifies the type of the object.
oldPassword
(IN) Points to the old password.
newPassword
(IN) Points to the new password.

Return Values

These are common return values. See Return Values (Return Values for C).

0x0000

SUCCESSFUL

0x89D7

PASSWORD_NOT_UNIQUE

0x89D8

PASSWORD_TOO_SHORT

0x89DC

ACCOUNT_DISABLED

0x89DE

PASSWORD_HAS_EXPIRED_NO_GRACE

0x89F0

WILD_CARD_NOT_ALLOWED

0x89FB

INVALID_PARAMETER

0x89FF

NO_SUCH_OBJECT_OR_BAD_PASSWORD

Remarks

NWChangeObjectPassword does not require the old password to be known.

For NWChangeObjectPassword to work properly, LOGIN_CONTROL must be set appropriately.

NWChangeObjectPassword attempts to change the password by using encryption. If the server does not support encryption, NWChangeObjectPassword attempts to change the password without using encryption.

Clients can change their own password. To change the password for other bindery objects, the client must be a SUPERVISOR or SUPERVISOR equivalent.

See Object Type.

NCP Calls

See Also

NWCreateObject, NWCreateProperty