CreateMessage Method

Adds a message to a queue.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* CreateMessage(const char* lpszQueueId, const char* lpszMessage);

Unicode (Windows)
LPWSTR CreateMessage(LPCWSTR lpszQueueId, LPCWSTR lpszMessage);

- (NSString*)createMessage:(NSString*)queueId :(NSString*)message;

#define MID_AMAZONSQS_CREATEMESSAGE 5

IPWORKSMQ_EXTERNAL int IPWORKSMQ_CALL IPWorksMQ_AmazonSQS_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Adds a message to the queue specified. If VisibilityTimeout is specified it is updated for all the messages in the queue.

CreateMessage returns a message id assigned to the message that is added to a queue. This can then be used to ListMessages or DeleteMessage.

Note: When adding a message to a FIFO queue, the MessageGroupId configuration setting must be populated before calling this method.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.