IsHOTPPasswordValid Method

Validates a hash-based one-time password.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int IsHOTPPasswordValid(const char* lpKeySecret, int lenKeySecret, int iPasswordLength, int iCounter, const char* lpszPassword);

Unicode (Windows)
INT IsHOTPPasswordValid(LPCSTR lpKeySecret, INT lenKeySecret, INT iPasswordLength, INT iCounter, LPCWSTR lpszPassword);

- (BOOL)isHOTPPasswordValid:(NSData*)keySecret :(int)passwordLength :(int)counter :(NSString*)password;

#define MID_OTPSERVER_ISHOTPPASSWORDVALID 3

SECUREBLACKBOX_EXTERNAL int SECUREBLACKBOX_CALL SecureBlackbox_OTPServer_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Use this method to validate a hash-based one-time password (HOTP) by using explicit HOTP parameters. For this method to work, no user details need to be provided in Users collection.

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.