Motorola CA50, Developer & User Manual

Page: 313 / 542

UCA Server Optional APIs 11 - 11
AuthenticateMAC
This method is used to authenticate a device. If authMac required is enabled, the MAC is looked up as a user in the
B_USER table.
int AuthenticateMAC(string sStoreNumber, string sMAC, string ipAddr ref AuthenticateResponse
AuthResp, ref UCAWebServiceStatus WSStatus)
Parameters
sStoreNumber
Device store number.
sMAC
Device MAC address.
ipAddr
IP address of source machine (optional - used for logging).
Pass "" when address logging is not required.
AuthResp
Result of authentication attempt. (See CA50 Device User Authentication Process on page 11-5 .)
WSStatus
UCAWebServiceStatus class describes the status of the call.
Return Values
Returns 1 when successful. If successful, AuthResp is populated with the result of the authentication attempt. If
return value is 0, check WSStatus for error code and description.
Remarks
Any errors are logged to the NT Event log.
Related Classes
public class AuthenticateResponse
{
public AuthenticateResponse (){}
public bool authenticated;
public bool continueOn;
public string token;
}
AuthenticateResponse Class Members
Table 11-4
AuthenticateResponse Class Members
Class Member Description
authenticated Is the user authenticated?
continueOn Are there more steps to the UCA Authentication Process?
token DB token representing the next step in the UCA Authentication Process, if
there is another step.