IoTHubModuleClient_LL_SetMessageCallback()

Sets up the message callback to be invoked when Edge issues a message to the module. This is a blocking call.

Syntax

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

IOTHUB_CLIENT_RESULT IoTHubModuleClient_LL_SetMessageCallback(
  IOTHUB_MODULE_CLIENT_LL_HANDLE        iotHubModuleClientHandle,
  IOTHUB_CLIENT_MESSAGE_CALLBACK_ASYNC  messageCallback,
  void *                                userContextCallback
);

Parameters

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

  • messageCallback The callback specified by the module for receiving messages from IoT Hub.

  • 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 IoTHubModuleClient_LL_Destroy function from within any callback.

Return Value

IOTHUB_CLIENT_OK upon success or an error code upon failure.