RequestAuth Method

Requests authentication to a device.

Syntax

• C++

ANSI (Cross Platform)
int RequestAuth(const char* lpszAddress, const char* lpszPassword);

Unicode (Windows)
INT RequestAuth(LPCWSTR lpszAddress, LPCWSTR lpszPassword);

#define MID_BTINFO_REQUESTAUTH 10

IPWORKSBT_EXTERNAL int IPWORKSBT_CALL IPWorksBT_BTInfo_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method requests authentication to the device specified by Address. The Password parameter is optional.

If Password is specified the authentication may take place without any further user interaction. When Password is not specified the connection wizard will be displayed by the system on both devices to complete mutual authentication. For instance:

btinfo.RequestAuth("00:02:72:C6:64:B7", "123456");

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)