Syntax

   #include <\nlm\nit\nwbindry.h>  
    
   int ChangeBinderyObjectPassword (  
      char   *objectName,  
      WORD   objectType,  
      char   *oldPassword,  
      char   *newPassword); 
   

Parameters

objectName

(IN) Specifies the string containing the name of the bindery object (maximum 48 characters, including the NULL terminator).

objectType

(IN) Specifies the type of the bindery object (OT_USER, OT_GROUP, OT_PRINT_SERVER, and so on).

oldPassword

(IN) Specifies the string containing the current password to be checked for validity (maximum 128 characters; NULL string = no password).

newPassword

(IN) Specifies the string containing the new password to be assigned to the bindery object (maximum 128 characters; NULL string = no password).

Return Values

Remarks

The objectName and objectType parameters must uniquely identify the bindery object and must not contain any wildcard characters. The objectName can be from 1 to 48 characters long, including the NULL terminator. Only printable characters can be used. Slashes, backslashes, colons, semicolons, commas, asterisks, and question marks are prohibited.

This function creates a property PASSWORD if the bindery object does not have one. It also assigns the property security (0x44) to the property PASSWORD. (Only the NetWare® OS can find the property or add value to the property.) The PASSWORD property is created with an associated bindery read and write access level, and the password property value is assigned the newPassword. A password can be from 1 to 128 characters long, including the NULL terminator.

Passwords are case sensitive. You can create passwords in lowercase or uppercase characters. When logging in, however, they must be entered exactly as when they were created.

There is a distinction between a bindery object without a password property and a bindery object with a password property that has no value. An entity is not allowed to log in to a server as a bindery object that does not have a password property. However, an entity is allowed to log in to a server as a bindery object that has a password property with no value. This function does not require that the requesting entity be logged in to the server.

This function requires read and write access to the bindery object.

See Also

VerifyBinderyObjectPassword