CLC_ErrorCode RemoteDevice_SmartConnectStart_Async	(	CPHOOKEDOBJECT const	hRemoteDevice,
		CPUINT16 const	wArraySize,
		CPDEVICEID const *const	arSourceDeviceIDs,
		CPUINT32 const	dwClientContextData,
		CPHASYNC *const	phAsync
	)

Initiate a SmartConnect session. Call this method from the RemoteDevice related to the target. The source device IDs array contains a list of controller devices to be assigned during this session.

Parameters

[in]	hRemoteDevice	Handle to the remote device.
[in]	wArraySize	source device ID array size: The CHAI theoretical max is about 80. In the CHAILink it relies on the CLMSG_MESSAGESIZE.
[in]	arSourceDeviceIDs	source device ID array
[in]	dwClientContextData	Data passed back to the ARH_REMOTEDEVICE_SMARTCONNECTSTART callback handler.
[out]	phAsync	Pointer to the handle of the async operation. Can be filled with NULL if the number of source device IDs is too high.

Returns

Standard CHAILink Client return code. See CLC_ErrorCode enumeration.

Warning

This function can only be called in CopperLan context. This means in the pseudo task CPDoProcess(), in notification handlers or in asynchronous return handlers and not in SystemDoProcess() for instance.