Microsoft Azure IoTHub client libraries
Dependents: sht15_remote_monitoring RobotArmDemo iothub_client_sample_amqp f767zi_mqtt ... more
This library implements the Microsoft Azure IoTHub client library. The code is replicated from https://github.com/Azure/azure-iot-sdks
iothub_message.h@77:e4e36df9caee, 2017-10-21 (annotated)
- Committer:
- AzureIoTClient
- Date:
- Sat Oct 21 20:11:49 2017 +0000
- Revision:
- 77:e4e36df9caee
- Parent:
- 74:ea0021abecf7
- Child:
- 88:248736be106e
1.1.26
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
AzureIoTClient | 16:deba40344375 | 1 | // Copyright (c) Microsoft. All rights reserved. |
AzureIoTClient | 16:deba40344375 | 2 | // Licensed under the MIT license. See LICENSE file in the project root for full license information. |
AzureIoTClient | 16:deba40344375 | 3 | |
AzureIoTClient | 16:deba40344375 | 4 | /** @file iothub_message.h |
AzureIoTClient | 16:deba40344375 | 5 | * @brief The @c IoTHub_Message component encapsulates one message that |
AzureIoTClient | 16:deba40344375 | 6 | * can be transferred by an IoT hub client. |
AzureIoTClient | 16:deba40344375 | 7 | */ |
AzureIoTClient | 16:deba40344375 | 8 | |
AzureIoTClient | 16:deba40344375 | 9 | #ifndef IOTHUB_MESSAGE_H |
AzureIoTClient | 16:deba40344375 | 10 | #define IOTHUB_MESSAGE_H |
AzureIoTClient | 16:deba40344375 | 11 | |
Azure.IoT Build | 38:a05929a75111 | 12 | #include "azure_c_shared_utility/macro_utils.h" |
Azure.IoT Build | 38:a05929a75111 | 13 | #include "azure_c_shared_utility/map.h" |
AzureIoTClient | 53:1e5a1ca1f274 | 14 | #include "azure_c_shared_utility/umock_c_prod.h" |
AzureIoTClient | 16:deba40344375 | 15 | |
AzureIoTClient | 16:deba40344375 | 16 | #ifdef __cplusplus |
AzureIoTClient | 16:deba40344375 | 17 | #include <cstddef> |
AzureIoTClient | 77:e4e36df9caee | 18 | extern "C" |
AzureIoTClient | 16:deba40344375 | 19 | { |
AzureIoTClient | 16:deba40344375 | 20 | #else |
AzureIoTClient | 16:deba40344375 | 21 | #include <stddef.h> |
AzureIoTClient | 16:deba40344375 | 22 | #endif |
AzureIoTClient | 16:deba40344375 | 23 | |
AzureIoTClient | 16:deba40344375 | 24 | #define IOTHUB_MESSAGE_RESULT_VALUES \ |
AzureIoTClient | 16:deba40344375 | 25 | IOTHUB_MESSAGE_OK, \ |
AzureIoTClient | 16:deba40344375 | 26 | IOTHUB_MESSAGE_INVALID_ARG, \ |
AzureIoTClient | 16:deba40344375 | 27 | IOTHUB_MESSAGE_INVALID_TYPE, \ |
AzureIoTClient | 16:deba40344375 | 28 | IOTHUB_MESSAGE_ERROR \ |
AzureIoTClient | 16:deba40344375 | 29 | |
AzureIoTClient | 77:e4e36df9caee | 30 | /** @brief Enumeration specifying the status of calls to various |
AzureIoTClient | 77:e4e36df9caee | 31 | * APIs in this module. |
AzureIoTClient | 77:e4e36df9caee | 32 | */ |
AzureIoTClient | 16:deba40344375 | 33 | DEFINE_ENUM(IOTHUB_MESSAGE_RESULT, IOTHUB_MESSAGE_RESULT_VALUES); |
AzureIoTClient | 16:deba40344375 | 34 | |
AzureIoTClient | 16:deba40344375 | 35 | #define IOTHUBMESSAGE_CONTENT_TYPE_VALUES \ |
AzureIoTClient | 16:deba40344375 | 36 | IOTHUBMESSAGE_BYTEARRAY, \ |
AzureIoTClient | 16:deba40344375 | 37 | IOTHUBMESSAGE_STRING, \ |
AzureIoTClient | 16:deba40344375 | 38 | IOTHUBMESSAGE_UNKNOWN \ |
AzureIoTClient | 16:deba40344375 | 39 | |
AzureIoTClient | 77:e4e36df9caee | 40 | /** @brief Enumeration specifying the content type of the a given |
AzureIoTClient | 77:e4e36df9caee | 41 | * message. |
AzureIoTClient | 77:e4e36df9caee | 42 | */ |
AzureIoTClient | 16:deba40344375 | 43 | DEFINE_ENUM(IOTHUBMESSAGE_CONTENT_TYPE, IOTHUBMESSAGE_CONTENT_TYPE_VALUES); |
AzureIoTClient | 16:deba40344375 | 44 | |
AzureIoTClient | 48:cc5d91f2b06d | 45 | typedef struct IOTHUB_MESSAGE_HANDLE_DATA_TAG* IOTHUB_MESSAGE_HANDLE; |
AzureIoTClient | 16:deba40344375 | 46 | |
AzureIoTClient | 77:e4e36df9caee | 47 | /** @brief diagnostic related data*/ |
AzureIoTClient | 77:e4e36df9caee | 48 | typedef struct IOTHUB_MESSAGE_DIAGNOSTIC_PROPERTY_DATA_TAG |
AzureIoTClient | 77:e4e36df9caee | 49 | { |
AzureIoTClient | 77:e4e36df9caee | 50 | char* diagnosticId; |
AzureIoTClient | 77:e4e36df9caee | 51 | char* diagnosticCreationTimeUtc; |
AzureIoTClient | 77:e4e36df9caee | 52 | }IOTHUB_MESSAGE_DIAGNOSTIC_PROPERTY_DATA, *IOTHUB_MESSAGE_DIAGNOSTIC_PROPERTY_DATA_HANDLE; |
AzureIoTClient | 77:e4e36df9caee | 53 | |
AzureIoTClient | 77:e4e36df9caee | 54 | static const char DIAG_CREATION_TIME_UTC_PROPERTY_NAME[] = "diag_creation_time_utc"; |
AzureIoTClient | 77:e4e36df9caee | 55 | |
AzureIoTClient | 16:deba40344375 | 56 | /** |
AzureIoTClient | 77:e4e36df9caee | 57 | * @brief Creates a new IoT hub message from a byte array. The type of the |
AzureIoTClient | 77:e4e36df9caee | 58 | * message will be set to @c IOTHUBMESSAGE_BYTEARRAY. |
AzureIoTClient | 77:e4e36df9caee | 59 | * |
AzureIoTClient | 77:e4e36df9caee | 60 | * @param byteArray The byte array from which the message is to be created. |
AzureIoTClient | 77:e4e36df9caee | 61 | * @param size The size of the byte array. |
AzureIoTClient | 77:e4e36df9caee | 62 | * |
AzureIoTClient | 77:e4e36df9caee | 63 | * @return A valid @c IOTHUB_MESSAGE_HANDLE if the message was successfully |
AzureIoTClient | 77:e4e36df9caee | 64 | * created or @c NULL in case an error occurs. |
AzureIoTClient | 77:e4e36df9caee | 65 | */ |
AzureIoTClient | 50:bbc71457b0ea | 66 | MOCKABLE_FUNCTION(, IOTHUB_MESSAGE_HANDLE, IoTHubMessage_CreateFromByteArray, const unsigned char*, byteArray, size_t, size); |
AzureIoTClient | 16:deba40344375 | 67 | |
AzureIoTClient | 16:deba40344375 | 68 | /** |
AzureIoTClient | 77:e4e36df9caee | 69 | * @brief Creates a new IoT hub message from a null terminated string. The |
AzureIoTClient | 77:e4e36df9caee | 70 | * type of the message will be set to @c IOTHUBMESSAGE_STRING. |
AzureIoTClient | 77:e4e36df9caee | 71 | * |
AzureIoTClient | 77:e4e36df9caee | 72 | * @param source The null terminated string from which the message is to be |
AzureIoTClient | 77:e4e36df9caee | 73 | * created. |
AzureIoTClient | 77:e4e36df9caee | 74 | * |
AzureIoTClient | 77:e4e36df9caee | 75 | * @return A valid @c IOTHUB_MESSAGE_HANDLE if the message was successfully |
AzureIoTClient | 77:e4e36df9caee | 76 | * created or @c NULL in case an error occurs. |
AzureIoTClient | 77:e4e36df9caee | 77 | */ |
AzureIoTClient | 50:bbc71457b0ea | 78 | MOCKABLE_FUNCTION(, IOTHUB_MESSAGE_HANDLE, IoTHubMessage_CreateFromString, const char*, source); |
AzureIoTClient | 16:deba40344375 | 79 | |
AzureIoTClient | 16:deba40344375 | 80 | /** |
AzureIoTClient | 77:e4e36df9caee | 81 | * @brief Creates a new IoT hub message with the content identical to that |
AzureIoTClient | 77:e4e36df9caee | 82 | * of the @p iotHubMessageHandle parameter. |
AzureIoTClient | 77:e4e36df9caee | 83 | * |
AzureIoTClient | 77:e4e36df9caee | 84 | * @param iotHubMessageHandle Handle to the message that is to be cloned. |
AzureIoTClient | 77:e4e36df9caee | 85 | * |
AzureIoTClient | 77:e4e36df9caee | 86 | * @return A valid @c IOTHUB_MESSAGE_HANDLE if the message was successfully |
AzureIoTClient | 77:e4e36df9caee | 87 | * cloned or @c NULL in case an error occurs. |
AzureIoTClient | 77:e4e36df9caee | 88 | */ |
AzureIoTClient | 50:bbc71457b0ea | 89 | MOCKABLE_FUNCTION(, IOTHUB_MESSAGE_HANDLE, IoTHubMessage_Clone, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 16:deba40344375 | 90 | |
AzureIoTClient | 16:deba40344375 | 91 | /** |
AzureIoTClient | 77:e4e36df9caee | 92 | * @brief Fetches a pointer and size for the data associated with the IoT |
AzureIoTClient | 77:e4e36df9caee | 93 | * hub message handle. If the content type of the message is not |
AzureIoTClient | 77:e4e36df9caee | 94 | * @c IOTHUBMESSAGE_BYTEARRAY then the function returns |
AzureIoTClient | 77:e4e36df9caee | 95 | * @c IOTHUB_MESSAGE_INVALID_ARG. |
AzureIoTClient | 77:e4e36df9caee | 96 | * |
AzureIoTClient | 77:e4e36df9caee | 97 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 77:e4e36df9caee | 98 | * @param buffer Pointer to the memory location where the |
AzureIoTClient | 77:e4e36df9caee | 99 | * pointer to the buffer will be written. |
AzureIoTClient | 77:e4e36df9caee | 100 | * @param size The size of the buffer will be written to |
AzureIoTClient | 77:e4e36df9caee | 101 | * this address. |
AzureIoTClient | 77:e4e36df9caee | 102 | * |
AzureIoTClient | 77:e4e36df9caee | 103 | * @return Returns IOTHUB_MESSAGE_OK if the byte array was fetched successfully |
AzureIoTClient | 77:e4e36df9caee | 104 | * or an error code otherwise. |
AzureIoTClient | 77:e4e36df9caee | 105 | */ |
AzureIoTClient | 50:bbc71457b0ea | 106 | MOCKABLE_FUNCTION(, IOTHUB_MESSAGE_RESULT, IoTHubMessage_GetByteArray, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle, const unsigned char**, buffer, size_t*, size); |
AzureIoTClient | 16:deba40344375 | 107 | |
AzureIoTClient | 16:deba40344375 | 108 | /** |
AzureIoTClient | 77:e4e36df9caee | 109 | * @brief Returns the null terminated string stored in the message. |
AzureIoTClient | 77:e4e36df9caee | 110 | * If the content type of the message is not @c IOTHUBMESSAGE_STRING |
AzureIoTClient | 77:e4e36df9caee | 111 | * then the function returns @c NULL. |
AzureIoTClient | 77:e4e36df9caee | 112 | * |
AzureIoTClient | 77:e4e36df9caee | 113 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 77:e4e36df9caee | 114 | * |
AzureIoTClient | 77:e4e36df9caee | 115 | * @return @c NULL if an error occurs or a pointer to the stored null |
AzureIoTClient | 77:e4e36df9caee | 116 | * terminated string otherwise. |
AzureIoTClient | 77:e4e36df9caee | 117 | */ |
AzureIoTClient | 50:bbc71457b0ea | 118 | MOCKABLE_FUNCTION(, const char*, IoTHubMessage_GetString, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 16:deba40344375 | 119 | |
AzureIoTClient | 16:deba40344375 | 120 | /** |
AzureIoTClient | 77:e4e36df9caee | 121 | * @brief Returns the content type of the message given by parameter |
AzureIoTClient | 77:e4e36df9caee | 122 | * @c iotHubMessageHandle. |
AzureIoTClient | 77:e4e36df9caee | 123 | * |
AzureIoTClient | 77:e4e36df9caee | 124 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 77:e4e36df9caee | 125 | * |
AzureIoTClient | 77:e4e36df9caee | 126 | * @remarks This function retrieves the standardized type of the payload, which indicates if @c iotHubMessageHandle was created using a String or a Byte Array. |
AzureIoTClient | 77:e4e36df9caee | 127 | * |
AzureIoTClient | 77:e4e36df9caee | 128 | * @return An @c IOTHUBMESSAGE_CONTENT_TYPE value. |
AzureIoTClient | 77:e4e36df9caee | 129 | */ |
AzureIoTClient | 50:bbc71457b0ea | 130 | MOCKABLE_FUNCTION(, IOTHUBMESSAGE_CONTENT_TYPE, IoTHubMessage_GetContentType, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 16:deba40344375 | 131 | |
AzureIoTClient | 16:deba40344375 | 132 | /** |
AzureIoTClient | 74:ea0021abecf7 | 133 | * @brief Sets the content-type of the message payload, as per supported values on RFC 2046. |
AzureIoTClient | 74:ea0021abecf7 | 134 | * |
AzureIoTClient | 74:ea0021abecf7 | 135 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 74:ea0021abecf7 | 136 | * |
AzureIoTClient | 74:ea0021abecf7 | 137 | * @param contentType String defining the type of the payload (e.g., text/plain). |
AzureIoTClient | 74:ea0021abecf7 | 138 | * |
AzureIoTClient | 74:ea0021abecf7 | 139 | * @return An @c IOTHUB_MESSAGE_RESULT value. |
AzureIoTClient | 74:ea0021abecf7 | 140 | */ |
AzureIoTClient | 74:ea0021abecf7 | 141 | MOCKABLE_FUNCTION(, IOTHUB_MESSAGE_RESULT, IoTHubMessage_SetContentTypeSystemProperty, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle, const char*, contentType); |
AzureIoTClient | 74:ea0021abecf7 | 142 | |
AzureIoTClient | 74:ea0021abecf7 | 143 | /** |
AzureIoTClient | 74:ea0021abecf7 | 144 | * @brief Returns the content-type of the message payload, if defined. |
AzureIoTClient | 74:ea0021abecf7 | 145 | * |
AzureIoTClient | 74:ea0021abecf7 | 146 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 74:ea0021abecf7 | 147 | * |
AzureIoTClient | 74:ea0021abecf7 | 148 | * @return A string with the content-type value if defined (or NULL otherwise). |
AzureIoTClient | 74:ea0021abecf7 | 149 | */ |
AzureIoTClient | 74:ea0021abecf7 | 150 | MOCKABLE_FUNCTION(, const char*, IoTHubMessage_GetContentTypeSystemProperty, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 74:ea0021abecf7 | 151 | |
AzureIoTClient | 74:ea0021abecf7 | 152 | /** |
AzureIoTClient | 74:ea0021abecf7 | 153 | * @brief Sets the content-encoding of the message payload, as per supported values on RFC 2616. |
AzureIoTClient | 74:ea0021abecf7 | 154 | * |
AzureIoTClient | 74:ea0021abecf7 | 155 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 74:ea0021abecf7 | 156 | * |
AzureIoTClient | 74:ea0021abecf7 | 157 | * @param contentEncoding String defining the encoding of the payload (e.g., utf-8). |
AzureIoTClient | 74:ea0021abecf7 | 158 | * |
AzureIoTClient | 74:ea0021abecf7 | 159 | * @return An @c IOTHUB_MESSAGE_RESULT value. |
AzureIoTClient | 74:ea0021abecf7 | 160 | */ |
AzureIoTClient | 74:ea0021abecf7 | 161 | MOCKABLE_FUNCTION(, IOTHUB_MESSAGE_RESULT, IoTHubMessage_SetContentEncodingSystemProperty, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle, const char*, contentEncoding); |
AzureIoTClient | 74:ea0021abecf7 | 162 | |
AzureIoTClient | 74:ea0021abecf7 | 163 | /** |
AzureIoTClient | 74:ea0021abecf7 | 164 | * @brief Returns the content-encoding of the message payload, if defined. |
AzureIoTClient | 74:ea0021abecf7 | 165 | * |
AzureIoTClient | 74:ea0021abecf7 | 166 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 74:ea0021abecf7 | 167 | * |
AzureIoTClient | 74:ea0021abecf7 | 168 | * @return A string with the content-encoding value if defined (or NULL otherwise). |
AzureIoTClient | 74:ea0021abecf7 | 169 | */ |
AzureIoTClient | 74:ea0021abecf7 | 170 | MOCKABLE_FUNCTION(, const char*, IoTHubMessage_GetContentEncodingSystemProperty, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 74:ea0021abecf7 | 171 | |
AzureIoTClient | 74:ea0021abecf7 | 172 | /** |
AzureIoTClient | 77:e4e36df9caee | 173 | * @brief Gets a handle to the message's properties map. |
AzureIoTClient | 77:e4e36df9caee | 174 | * |
AzureIoTClient | 77:e4e36df9caee | 175 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 77:e4e36df9caee | 176 | * |
AzureIoTClient | 77:e4e36df9caee | 177 | * @return A @c MAP_HANDLE pointing to the properties map for this message. |
AzureIoTClient | 77:e4e36df9caee | 178 | */ |
AzureIoTClient | 50:bbc71457b0ea | 179 | MOCKABLE_FUNCTION(, MAP_HANDLE, IoTHubMessage_Properties, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 16:deba40344375 | 180 | |
AzureIoTClient | 16:deba40344375 | 181 | /** |
AzureIoTClient | 18:1e9adb15c645 | 182 | * @brief Gets the MessageId from the IOTHUB_MESSAGE_HANDLE. |
AzureIoTClient | 18:1e9adb15c645 | 183 | * |
AzureIoTClient | 18:1e9adb15c645 | 184 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 18:1e9adb15c645 | 185 | * |
AzureIoTClient | 18:1e9adb15c645 | 186 | * @return A const char* pointing to the Message Id. |
AzureIoTClient | 18:1e9adb15c645 | 187 | */ |
AzureIoTClient | 50:bbc71457b0ea | 188 | MOCKABLE_FUNCTION(, const char*, IoTHubMessage_GetMessageId, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 18:1e9adb15c645 | 189 | |
AzureIoTClient | 18:1e9adb15c645 | 190 | /** |
AzureIoTClient | 18:1e9adb15c645 | 191 | * @brief Sets the MessageId for the IOTHUB_MESSAGE_HANDLE. |
AzureIoTClient | 18:1e9adb15c645 | 192 | * |
AzureIoTClient | 18:1e9adb15c645 | 193 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 18:1e9adb15c645 | 194 | * @param messageId Pointer to the memory location of the messageId |
AzureIoTClient | 18:1e9adb15c645 | 195 | * |
AzureIoTClient | 18:1e9adb15c645 | 196 | * @return Returns IOTHUB_MESSAGE_OK if the messageId was set successfully |
AzureIoTClient | 18:1e9adb15c645 | 197 | * or an error code otherwise. |
AzureIoTClient | 18:1e9adb15c645 | 198 | */ |
AzureIoTClient | 50:bbc71457b0ea | 199 | MOCKABLE_FUNCTION(, IOTHUB_MESSAGE_RESULT, IoTHubMessage_SetMessageId, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle, const char*, messageId); |
AzureIoTClient | 18:1e9adb15c645 | 200 | |
AzureIoTClient | 18:1e9adb15c645 | 201 | /** |
AzureIoTClient | 18:1e9adb15c645 | 202 | * @brief Gets the CorrelationId from the IOTHUB_MESSAGE_HANDLE. |
AzureIoTClient | 18:1e9adb15c645 | 203 | * |
AzureIoTClient | 18:1e9adb15c645 | 204 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 18:1e9adb15c645 | 205 | * |
AzureIoTClient | 18:1e9adb15c645 | 206 | * @return A const char* pointing to the Correlation Id. |
AzureIoTClient | 18:1e9adb15c645 | 207 | */ |
AzureIoTClient | 50:bbc71457b0ea | 208 | MOCKABLE_FUNCTION(, const char*, IoTHubMessage_GetCorrelationId, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 18:1e9adb15c645 | 209 | |
AzureIoTClient | 18:1e9adb15c645 | 210 | /** |
AzureIoTClient | 18:1e9adb15c645 | 211 | * @brief Sets the CorrelationId for the IOTHUB_MESSAGE_HANDLE. |
AzureIoTClient | 18:1e9adb15c645 | 212 | * |
AzureIoTClient | 18:1e9adb15c645 | 213 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 18:1e9adb15c645 | 214 | * @param correlationId Pointer to the memory location of the messageId |
AzureIoTClient | 18:1e9adb15c645 | 215 | * |
AzureIoTClient | 18:1e9adb15c645 | 216 | * @return Returns IOTHUB_MESSAGE_OK if the messageId was set successfully |
AzureIoTClient | 18:1e9adb15c645 | 217 | * or an error code otherwise. |
AzureIoTClient | 18:1e9adb15c645 | 218 | */ |
AzureIoTClient | 50:bbc71457b0ea | 219 | MOCKABLE_FUNCTION(, IOTHUB_MESSAGE_RESULT, IoTHubMessage_SetCorrelationId, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle, const char*, correlationId); |
AzureIoTClient | 18:1e9adb15c645 | 220 | |
AzureIoTClient | 18:1e9adb15c645 | 221 | /** |
AzureIoTClient | 77:e4e36df9caee | 222 | * @brief Gets the DiagnosticData from the IOTHUB_MESSAGE_HANDLE. CAUTION: SDK user should not call it directly, it is for internal use only. |
AzureIoTClient | 77:e4e36df9caee | 223 | * |
AzureIoTClient | 77:e4e36df9caee | 224 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 77:e4e36df9caee | 225 | * |
AzureIoTClient | 77:e4e36df9caee | 226 | * @return A const IOTHUB_MESSAGE_DIAGNOSTIC_PROPERTY_DATA* pointing to the diagnostic property data. |
AzureIoTClient | 77:e4e36df9caee | 227 | */ |
AzureIoTClient | 77:e4e36df9caee | 228 | MOCKABLE_FUNCTION(, const IOTHUB_MESSAGE_DIAGNOSTIC_PROPERTY_DATA*, IoTHubMessage_GetDiagnosticPropertyData, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 77:e4e36df9caee | 229 | |
AzureIoTClient | 77:e4e36df9caee | 230 | /** |
AzureIoTClient | 77:e4e36df9caee | 231 | * @brief Sets the DiagnosticData for the IOTHUB_MESSAGE_HANDLE. CAUTION: SDK user should not call it directly, it is for internal use only. |
AzureIoTClient | 77:e4e36df9caee | 232 | * |
AzureIoTClient | 77:e4e36df9caee | 233 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 77:e4e36df9caee | 234 | * @param diagnosticData Pointer to the memory location of the diagnosticData |
AzureIoTClient | 77:e4e36df9caee | 235 | * |
AzureIoTClient | 77:e4e36df9caee | 236 | * @return Returns IOTHUB_MESSAGE_OK if the DiagnosticData was set successfully |
AzureIoTClient | 77:e4e36df9caee | 237 | * or an error code otherwise. |
AzureIoTClient | 77:e4e36df9caee | 238 | */ |
AzureIoTClient | 77:e4e36df9caee | 239 | MOCKABLE_FUNCTION(, IOTHUB_MESSAGE_RESULT, IoTHubMessage_SetDiagnosticPropertyData, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle, const IOTHUB_MESSAGE_DIAGNOSTIC_PROPERTY_DATA*, diagnosticData); |
AzureIoTClient | 77:e4e36df9caee | 240 | |
AzureIoTClient | 77:e4e36df9caee | 241 | /** |
AzureIoTClient | 77:e4e36df9caee | 242 | * @brief Frees all resources associated with the given message handle. |
AzureIoTClient | 77:e4e36df9caee | 243 | * |
AzureIoTClient | 77:e4e36df9caee | 244 | * @param iotHubMessageHandle Handle to the message. |
AzureIoTClient | 77:e4e36df9caee | 245 | */ |
AzureIoTClient | 50:bbc71457b0ea | 246 | MOCKABLE_FUNCTION(, void, IoTHubMessage_Destroy, IOTHUB_MESSAGE_HANDLE, iotHubMessageHandle); |
AzureIoTClient | 16:deba40344375 | 247 | |
AzureIoTClient | 16:deba40344375 | 248 | #ifdef __cplusplus |
AzureIoTClient | 16:deba40344375 | 249 | } |
AzureIoTClient | 16:deba40344375 | 250 | #endif |
AzureIoTClient | 16:deba40344375 | 251 | |
AzureIoTClient | 16:deba40344375 | 252 | #endif /* IOTHUB_MESSAGE_H */ |