IQueueingServiceClaimMessageAsync Method |
This API is preliminary and subject to change.
Claim messages from a queue.
Namespace: net.openstack.Core.ProvidersAssembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c
Syntax Task<Claim> ClaimMessageAsync(
QueueName queueName,
Nullable<int> limit,
TimeSpan timeToLive,
TimeSpan gracePeriod,
CancellationToken cancellationToken
)
Function ClaimMessageAsync (
queueName As QueueName,
limit As Nullable(Of Integer),
timeToLive As TimeSpan,
gracePeriod As TimeSpan,
cancellationToken As CancellationToken
) As Task(Of Claim)
Task<Claim^>^ ClaimMessageAsync(
QueueName^ queueName,
Nullable<int> limit,
TimeSpan timeToLive,
TimeSpan gracePeriod,
CancellationToken cancellationToken
)
abstract ClaimMessageAsync :
queueName : QueueName *
limit : Nullable<int> *
timeToLive : TimeSpan *
gracePeriod : TimeSpan *
cancellationToken : CancellationToken -> Task<Claim>
Parameters
- queueName
- Type: net.openstack.Core.Domain.QueuesQueueName
The queue name. - limit
- Type: SystemNullableInt32
The maximum number of messages to claim. If this value is , a provider-specific default value is used. - timeToLive
- Type: SystemTimeSpan
The time to wait before the server automatically releases the claim. - gracePeriod
- Type: SystemTimeSpan
The time to wait, after the time-to-live for the claim expires, before the server allows the claimed messages to be deleted due to the individual message's time-to-live expiring. - cancellationToken
- Type: System.ThreadingCancellationToken
The CancellationToken that the task will observe.
Return Value
Type:
TaskClaimA
Task object representing the asynchronous operation. When the task completes successfully, the
Result property will contain
Claim object representing the claim.
Exceptions Remarks When the claim is no longer required, the code should call DisposeAsync(CancellationToken)
or Dispose to ensure the following actions are taken.
- Messages which are part of this claim which were not processed are made available to other nodes.
- The claim resource is cleaned up without waiting for the time-to-live to expire.
Messages which are not deleted before the claim is released will be eligible for
reclaiming by another process.
Version Information .NET Framework
Supported in: 4.5
openstack.net
Supported in: 1.6, 1.5, 1.4, 1.3.6
See Also