The method_chpass Interface

int method_chpass (void *handlep, char *user, char *oldpassword, char *newpassword, char **message);

The handlep parameter is a handle to the load module opened with the method_open interface. The user parameter points to the requested user. The oldpassword parameter points to the user's current password. The newpassword parameter points to the user's new password. The message parameter points to a character pointer. It will be set to a message which is output to the user.

method_chpass changes the authentication information for a user account.

method_chpass is called indirectly as a result of calling the chpass subroutine. The security library will examine the registry attribute for the user and invoke the method_chpass interface for the named loadable authentication module.

method_chpass returns zero for success or -1 for failure. On failure the message parameter should be initialized with a user message.