CLC_ErrorCode RemoteDevice_Learn	(	CPHOOKEDOBJECT const	hRemoteDevice,
		CPBOOLEAN const	fActivate,
		CPUINT16 const	wControllerID
	)

Set the remote device in learning mode.

Parameters

[in]	hRemoteDevice	Handle to the remote device.
[in]	fActivate	TRUE to activate the learn mode, FALSE to stop it.
[in]	wControllerID	The controller ID to be assigned by learning.

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.