ValidatePassword Method

Validates a HMAC-Based One Time Password.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int ValidatePassword();

Unicode (Windows)
INT ValidatePassword();

- (BOOL)validatePassword;

#define MID_HOTP_VALIDATEPASSWORD 5

IPWORKSAUTH_EXTERNAL int IPWORKSAUTH_CALL IPWorksAuth_HOTP_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method validates a HMAC-Based One Time Password.

The following properties are applicable when calling ValidatePassword.

• Password (required)
• Secret (required)
• Counter (required)

The method will return True if the password is validated, False otherwise.

Error Handling (C++)

This method returns a Boolean value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.