3.1.4.17.1 ValidateUser (Opnum 3)
This method is called by a client to verify that a user account and password are valid.
-
HRESULT ValidateUser( [in, string, unique] LPWSTR pwszPrincipalName, [in, string, unique] LPWSTR pwszPassword );
pwszPrincipalName: The principal name of the user account.
pwszPassword: A password for the user account.
Return Values: This method MUST return a value in the table below on success, or a failure result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST be treated identically.
-
Return value/code
Description
0x00000000
S_OK
The user account and password are valid.
0x00000001
S_FALSE
The user account was not found or the password was invalid.
Upon receiving a call to this method, a server MUST attempt to verify that the principal name identifies a user account and that the password specified is valid for that account, and fail the call if not.
The server MUST then return S_OK if the user account and password are valid, or S_FALSE if not.