Freigeben über


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.