SDK API > BS2_EnableDeviceLicense


BS2_EnableDeviceLicense

[+ 2.9.1] 라이선스를 활성화 시킬 장치들과, 라이선스 파일을 지정하여 장치 라이선스를 활성화 시킵니다.
마스터 장치 및 그와 연결된 슬레이브 장치들에 대한 일괄 지정이 가능하며, 활성화에 대한 장치별 결과는 outResultObj 및 outNumOfResult를 통해 반환됩니다.
이 기능은 장치가 라이선스 활성화 기능을 지원해야 하며, 현재 기능을 지원하는 장치 정보는 아래와 같습니다.

지원장치 펌웨어
XS2-Finger V1.2.0
XS2-Card V1.2.0
BS3 V1.1.0

함수

#include "BS_API.h"
 
int BS2_EnableDeviceLicense(void* context, uint32_t deviceId, const BS2LicenseBlob* licenseBlob, BS2LicenseResult** outResultObj, uint32_t* outNumOfResult);

파라미터

참고
outResultObj 변수는 사용 후 BS2_ReleaseObject 함수를 통해 시스템에 메모리를 반환해야 합니다.

반환값

성공적으로 수행될 경우 BS_SDK_SUCCESS를 반환하고, 에러가 발생할 경우 상응하는 에러 코드를 반환합니다.

샘플코드(C++)

sample_bs2_enabledevicelicense.cpp
int setDeviceLicense(void* context, BS2_DEVICE_ID id)
{
	DeviceControl dc(context);
	BS2LicenseBlob licenseBlob = { 0, };
	vector<BS2_DEVICE_ID> deviceIDs;
	vector<BS2LicenseResult> licenseResult;
	int sdkResult = BS_SDK_SUCCESS;
 
	licenseBlob.licenseType = (BS2_LICENSE_TYPE)Utility::getInput<uint32_t>("Enter the license type. (0: None, 1: Visual QR)");
	licenseBlob.numOfDevices = (uint16_t)Utility::getInput<uint32_t>("How many devices do you want to register?");
	if (0 < licenseBlob.numOfDevices)
	{
		// Device ID
		for (uint16_t idx = 0; idx < licenseBlob.numOfDevices; idx++)
		{
			BS2_DEVICE_ID deviceID = (BS2_DEVICE_ID)Utility::getInput<uint32_t>("Enter a device ID:");
			deviceIDs.push_back(deviceID);
		}
 
		licenseBlob.deviceIDObjs = deviceIDs.data();
 
		string pathName = Utility::getLine("Enter the path and name of license.");
		licenseBlob.licenseLen = Utility::getResourceSize(pathName);
		shared_ptr<uint8_t> buffer(new uint8_t[licenseBlob.licenseLen], ArrayDeleter<uint8_t>());
		if (0 < licenseBlob.licenseLen && Utility::getResourceFromFile(pathName, buffer, licenseBlob.licenseLen))
		{
			licenseBlob.licenseObj = buffer.get();
 
			sdkResult = dc.enableDeviceLicense(id, &licenseBlob, licenseResult);
			if (BS_SDK_SUCCESS == sdkResult)
				DeviceControl::print(licenseResult);
		}
	}
 
	return sdkResult;
}
 
int DeviceControl::enableDeviceLicense(BS2_DEVICE_ID id, const BS2LicenseBlob* licenseBlob, vector<BS2LicenseResult>& licenseResult)
{
	BS2LicenseResult* result = NULL;
	uint32_t numOfResult = 0;
	int sdkResult = BS2_EnableDeviceLicense(context_, id, licenseBlob, &result, &numOfResult);
	if (BS_SDK_SUCCESS != sdkResult)
	{
		TRACE("BS2_EnableDeviceLicense call failed: %d", sdkResult);
		return sdkResult;
	}
 
	licenseResult.clear();
	for (uint32_t idx = 0; idx < numOfResult; idx++)
	{
		licenseResult.push_back(result[idx]);
	}
 
	return sdkResult;
}

샘플코드(C#)

sample_bs2_enabledevicelicense.cs
	BS2LicenseBlob licenseBlob = Util.AllocateStructure<BS2LicenseBlob>();
 
	Console.WriteLine("Try adding a license");
 
	Console.WriteLine("Enter the license type. (0: None, 1: Visual QR)");
	Console.Write(">>>> ");
	licenseBlob.licenseType = Util.GetInput((UInt16)BS2LicenseType.VISUAL_QR_MASK);
 
	Console.WriteLine("How many devices do you want to register?");
	Console.Write(">>>> ");
	licenseBlob.numOfDevices = Util.GetInput((UInt16)1);
 
	if (0 < licenseBlob.numOfDevices)
	{
		// Device ID
		List<UInt32> listID = new List<UInt32>();
		UInt32 tempID = 0;
		for (UInt16 idx = 0; idx < licenseBlob.numOfDevices; idx++)
		{
			Console.WriteLine("  Slave device ID #{0}", idx);
			Console.Write("  >> ");
			tempID = (UInt32)Util.GetInput();
			listID.Add(tempID);
		}
 
		byte[] byteListID = listID.SelectMany(BitConverter.GetBytes).ToArray();
		int byteCount = Marshal.SizeOf(typeof(UInt32)) * licenseBlob.numOfDevices;
 
		licenseBlob.deviceIDObjs = Marshal.AllocHGlobal(byteCount);
		Marshal.Copy(byteListID, 0, licenseBlob.deviceIDObjs, byteCount);
 
		// License data
		Console.WriteLine("Enter the path and name of license.");
		Console.Write(">>>> ");
		string licensePath = Console.ReadLine();
		if (!File.Exists(licensePath))
		{
			Console.WriteLine("Invalid license Path");
			return;
		}
 
		if (Util.LoadBinary(licensePath, out licenseBlob.licenseObj, out licenseBlob.licenseLen))
		{
			IntPtr resultObj = IntPtr.Zero;
			UInt32 numOfResult = 0;
 
			BS2ErrorCode result = (BS2ErrorCode)API.BS2_EnableDeviceLicense(sdkContext, deviceID, ref licenseBlob, out resultObj, out numOfResult);
			Marshal.FreeHGlobal(licenseBlob.licenseObj);
 
			if (BS2ErrorCode.BS_SDK_SUCCESS != result)
			{
				Console.WriteLine("Got error({0}).", result);
			}
			else
			{
				IntPtr curResult = resultObj;
				int resultSize = Marshal.SizeOf(typeof(BS2LicenseResult));
				for (UInt32 idx = 0; idx < numOfResult; idx++)
				{
					BS2LicenseResult item = (BS2LicenseResult)Marshal.PtrToStructure(curResult, typeof(BS2LicenseResult));
					print(item, idx);
					curResult += resultSize;
				}
 
				API.BS2_ReleaseObject(resultObj);
			}
		} // if (Util.LoadBinary(licensePath, out licenseBlob.licenseObj, out licenseBlob.licenseLen))
	} // if (0 < licenseBlob.numOfDevices)
 
	Marshal.FreeHGlobal(licenseBlob.deviceIDObjs);