NetUserChangePassword

Overview

Group

Quick Info

Windows NT
Yes
Win95
No
Win32s
No
Import Library
netapi32.lib
Header File
lmaccess.h
Unicode
WinNT
Platform Notes
All LanMan APIs are UNICODE only

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.