Begins an asynchronous operation to update the visibility delay of a message, and optionally the contents of a message. Namespace: Microsoft.WindowsAzure.StorageClient
Assembly: Microsoft.WindowsAzure.StorageClient (in Microsoft.WindowsAzure.StorageClient.dll)
Usage
| Visual Basic |
|---|
Dim instance As CloudQueue Dim message As CloudQueueMessage Dim visibilityTimeout As TimeSpan Dim updateFields As MessageUpdateFields Dim callback As AsyncCallback Dim state As Object Dim returnValue As IAsyncResult returnValue = instance.BeginUpdateMessage(message, visibilityTimeout, updateFields, callback, state) |
Syntax
| Visual Basic |
|---|
Public Function BeginUpdateMessage ( _ message As CloudQueueMessage, _ visibilityTimeout As TimeSpan, _ updateFields As MessageUpdateFields, _ callback As AsyncCallback, _ state As Object _ ) As IAsyncResult |
| C# |
|---|
public IAsyncResult BeginUpdateMessage ( CloudQueueMessage message, TimeSpan visibilityTimeout, MessageUpdateFields updateFields, AsyncCallback callback, Object state ) |
| C++ |
|---|
public: IAsyncResult^ BeginUpdateMessage ( CloudQueueMessage^ message, TimeSpan visibilityTimeout, MessageUpdateFields updateFields, AsyncCallback^ callback, Object^ state ) |
| J# |
|---|
| JScript |
|---|
Parameters
- message
A queue message.
- visibilityTimeout
The visibility delay for the message.
- updateFields
Indicates whether to update the visibility delay, message contents, or both.
- callback
The callback delegate that will receive notification when the asynchronous operation completes.
- state
A user-defined object that will be passed to the callback delegate.
Return Value
An IAsyncResult that references the asynchronous operation.Remarks
The BeginUpdateMessage method must specify the visibility delay of a message.
After a client retrieves a message by calling the GetMessage or GetMessages(Int32) method, the client is expected to process and update the message. When a message is retrieved, its PopReceipt property is set to an opaque value that indicates the message has been read. The value of the message’s pop receipt is used to verify that the message being updated is the same message that was read.
A pop receipt remains valid until one of the following events occurs:
The message has expired.
The message has been deleted using the last pop receipt received either from GetMessages(Int32) or BeginUpdateMessage.
The invisibility time has elapsed and the message has been dequeued by a GetMessages(Int32) request. When the invisibility time elapses, the message becomes visible again. If it is retrieved by another GetMessages(Int32) request, the returned pop receipt can be used to delete or update the message.
The message has been updated with a new visibility timeout. When the message is updated, a new pop receipt will be returned.
The BeginUpdateMessage operation can be used to continually extend the invisibility of a queue message. This functionality can be useful if you want a worker role to “lease” a queue message. For example, if a worker role calls GetMessages(Int32) and recognizes that it needs more time to process a message, it can continually extend the message’s invisibility until it is processed. If the worker role were to fail during processing, eventually the message would become visible again and another worker role could process it.