ChangeMessageVisibility Method

Changes the visibility timeout of a message.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* ChangeMessageVisibility(const char* lpszQueueId, const char* lpszReceiptHandle, int iVisiblityTimeout);

Unicode (Windows)
LPWSTR ChangeMessageVisibility(LPCWSTR lpszQueueId, LPCWSTR lpszReceiptHandle, INT iVisiblityTimeout);

- (NSString*)changeMessageVisibility:(NSString*)queueId :(NSString*)receiptHandle :(int)visiblityTimeout;

#define MID_AMAZONSQS_CHANGEMESSAGEVISIBILITY 3

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

Remarks

Changes the visibility of the message specified by ReceiptHandle in the queue specified by QueueId. The maximum allowed timeout value you can set the value to is 12 hours. This means you can't extend the timeout of a message in an existing queue to more than a total visibility timeout of 12 hours.

This method returns the RequestId contained in the Amazon response.

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.