DeleteMessage Method

Deletes the specified message from the queue.

Syntax

[VB.NET]
Public Sub DeleteMessage(ByVal MessageId As String, ByVal PopReceipt As String)

[C#]
public void DeleteMessage(string messageId, string popReceipt);

Remarks

This method deletes the message identified by the MessageID and PopReceipt parameters.

When a message is retrieved by calling ListMessages the user is responsible for deleting the message from the queue.

If you plan to delete the message, after calling ListMessages store Id and PopReceipt. These two values are required when deleting a message.

If you do not wish to delete a message, note that the message will be reserved for deletion and cannot be retrieved by other clients until VisibilityTimeout expires. After that time, other clients may retrieve and delete the message. The message may be deleted at any time, even after VisibilityTimeout has expired, given that it still exists in the queue.

When a message is successfully deleted, it is immediately marked for deletion and is no longer accessible to clients. The message is later removed from the queue during garbage collection.

If the message has already been deleted when DeleteMessage is called, the Queue service returns status code 404 (Not Found). If a message with a matching PopReceipt is not found, the service returns status code 400 (Bad Request).