~~NOTOC~~
[[sdk_api]] > [[BS2_InitializeEx]]

----

===== BS2_InitializeEx =====
Initializes the context and initializes the socket with the IP address specified as the second argument.

<WRAP info 70%>
**NOTE**\\
It must be called before calling the device control API.
</WRAP>

==== Declaration ====
<code cpp>
#include "BS_API.h"

int BS2_InitializeEx(void* context, const char* hostIPAddr);
</code>

==== Parameter ====
  * [In] ''//context//'' : Context
  * [In] ''//hostIPAddr//'' : host IP Address

==== Return Value ====
If successfully done, ''BS_SDK_SUCCESS''will be returned. If there is an error, the corresponding error code will be returned.

==== Sample Code(C++) ====
<file cpp sample_bs2_initializeex.cpp>
void initializeSDK()
{
	void* context_ = BS2_AllocateContext();

	string hostAddr = Utility::getInput<string>("Please enter the host network address.");
	sdkResult = BS2_InitializeEx(context_, hostAddr.c_str());
	if (BS_SDK_SUCCESS != sdkResult)
	{
		TRACE("BS2_InitializeEx call failed: %d", sdkResult);
		BS2_ReleaseContext(context_);
		context_ = NULL;
	}
}
</file>

==== Sample Code(C#) ====
<file csharp sample_bs2_initializeex.cs>
public void initializeSDK()
{
	sdkContext = API.BS2_AllocateContext();
	if (sdkContext == IntPtr.Zero)
	{
		Console.WriteLine("Can't allocate sdk context.");
		return;
	}

	string deviceIpAddress = Console.ReadLine();
	IntPtr ptrIPAddr = Marshal.StringToHGlobalAnsi(deviceIpAddress);

	BS2ErrorCode result = (BS2ErrorCode)API.BS2_InitializeEx(sdkContext, ptrIPAddr);
	if (result != BS2ErrorCode.BS_SDK_SUCCESS)
	{
		Console.WriteLine("SDK initialization failed with : {0}, {1}", result, deviceIpAddress);
		API.BS2_ReleaseContext(sdkContext);
		sdkContext = IntPtr.Zero;
		return;
	}
}
</file>