Syntax

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE NWAPI  NWDisallowObjectPassword  ( 
      NWCONN_HANDLE       conn,  
      const nstr8 N_FAR  *objName,  
      nuint16             objType,  
      const nstr8 N_FAR  *disallowedPassword);
   

   uses calwin32 
    
   Function NWDisallowObjectPassword 
     (conn : NWCONN_HANDLE; 
      const objName : pnstr8; 
      objType : nuint16; 
      const disallowedPassword : pnstr8 
   ) : NWCCODE; stdcall;
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

objName

(IN) Points to the name of the object whose password is being disallowed.

objType

(IN) Specifies the type of the object whose password is being disallowed.

disallowedPassword

(IN) Points to the password that is being disallowed.

Return Values

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

Remarks

The objName and objType parameters must be specific and cannot contain wildcards.

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

NWDisallowObjectPassword adds an encrypted password to the list of old passwords maintained in the OLD_PASSWORDS property. If the OLD_PASSWORDS property does not exist, NWDisallowObjectPassword will check UNIQUE_PASSWORDS of the restriction flags in the LOGIN_CONTROL property. If the UNIQUE_PASSWORDS is set, the OLD_PASSWORDS property will be created. Otherwise, a BINDERY_FAILURE error code will be returned.

See Object Type.

NCP Calls

• 0x2222 23 53 Get Bindery Object ID
• 0x2222 23 57 Create Property
• 0x2222 23 61 Read Property Value
• 0x2222 23 62 Write Property Value

See Also

NWChangeObjectPassword, NWLoginToFileServer (Server Management)