This API specifies a call back to be used when the device receives a desired state update.


#include "azure-iot-sdk-c/iothub_client/inc/iothub_client_ll.h"

IOTHUB_CLIENT_RESULT IoTHubClient_LL_SetDeviceTwinCallback(
  IOTHUB_CLIENT_LL_HANDLE             iotHubClientHandle,
  void *                              userContextCallback


  • iotHubClientHandle The handle created by a call to the create function.

  • deviceTwinCallback The callback specified by the device client to be used for updating the desired state. The callback will be called in response to patch request send by the IoTHub services. The payload will be passed to the callback, along with two version numbers:

  • Desired:

  • LastSeenReported:

  • userContextCallback User specified context that will be provided to the callback. This can be NULL.

NOTE: The application behavior is undefined if the user calls the IoTHubClient_LL_Destroy function from within any callback.

Return Value

IOTHUB_CLIENT_OK upon success or an error code upon failure.