NetUserChangePassword info Overview Group

The NetUserChangePassword function changes a user’s password for a specified network server or domain.

Security Requirements

A server or domain can be configured to require a user to log on before changing the password on a user account. In that case, only members of the Administrators or Account Operators local group or the user himself can change the password for a user account. If logging on is not required, the user can change the password for any user account, as long as the user knows the current password.

NET_API_STATUS NetUserChangePassword(

LPWSTR domainname,

LPWSTR username,

LPWSTR oldpassword,

LPWSTR newpassword

);

Parameters

domainname: Pointer to a null-terminated Unicode string that specifies the name of a remote server or domain. The NetUserChangePassword function changes the user’s password on that remote server or domain.
A value of NULL in the domainname parameter specifies the logon domain of the caller.
username: Pointer to a null-terminated Unicode string that specifies a user name. The NetUserChangePassword function changes the password for that user.
A value of NULL in the username parameter specifies the logon user name of the caller.
oldpassword: Pointer to a null-terminated Unicode string that specifies the user’s old password on the server or domain.
newpassword: Pointer to a null-terminated Unicode string that specifies the user’s new password on the server or domain.

Return Values

If the function is successful, it returns account information and the return value is NET_API_STATUS.

If the function fails, the return value is one of the following error codes.

Value

Meaning

ERROR_ACCESS_DENIED

The user does not have access to the requested information.

NERR_InvalidComputer

The computer name is invalid.

NERR_NotPrimary

The operation is allowed only on the primary domain controller of the domain.

NERR_UserNotFound

The user name could not be found.

NERR_PasswordTooShort

The password is shorter than required.

LPWSTR domainname,
LPWSTR username,
LPWSTR oldpassword,
LPWSTR newpassword
);

Value	Meaning
ERROR_ACCESS_DENIED	The user does not have access to the requested information.
NERR_InvalidComputer	The computer name is invalid.
NERR_NotPrimary	The operation is allowed only on the primary domain controller of the domain.
NERR_UserNotFound	The user name could not be found.
NERR_PasswordTooShort	The password is shorter than required.

NetUserChangePassword info Overview Group

Security Requirements

Parameters

Return Values

See Also