Jobs_StartNextMsg

size_t Jobs_StartNextMsg( const char * clientToken,
                          size_t clientTokenLength,
                          char * buffer,
                          size_t bufferSize );

Populate a message string for a StartNextPendingJobExecution request.

Parameters

clientToken	The device's token
clientTokenLength	The expected length of the clientToken
buffer	The buffer to be written to
bufferSize	The size of the buffer

Returns

0 if write to buffer fails

The message length if the write is successful

Example

// The Following Example shows usage of the Jobs_StartNextMsg API
// to generate a message string for a StartNextPendingJobExecution request.
 
const char * clientToken = "test";
size_t clientTokenLength = ( sizeof( clientToken ) - 1U );
char messageBuffer[ START_JOB_MSG_LENGTH ] = {0};
size_t messageLength = 0U;
 
messageLength = Jobs_StartNextMsg( clientToken,
                                   clientTokenLength,
                                   messageBuffer,
                                   START_JOB_MSG_LENGTH );
 
if ( messageLength > 0 )
{
    // The message string of the clientToken has been generated in
    // the buffer, messageBuffer, for the StartNextPendingJobExecution request
    // Publish to the topic string generated by Jobs_StartNext() using an
    // MQTT client of your choice.
}