CHAILink SDK  Version 1.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
CLC_ErrorCode CHAI_RemoveLocalDevice ( CPHOBJECT const  LocalDeviceHandle)

Remove a local device.

Parameters
[in]LocalDeviceHandlehandle to the local device to remove.
Returns
Standard CHAILink Client return code. See CLC_ErrorCode enumeration.
Remarks
Removing a local device that is not a root device (a local device for which SetParent has been called with a non NULL pointer) might result in parent capabilities change. In this case, it is recommended to call the Root device's Declare() method to refresh its capabilities visibility over the network.
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.