Skip to content

IMessagingExtension Methods

The grain extension through which other grains exchange durable messages with this grain.

DeliverAsync(InboxMessage, CancellationToken)

abstract
[Orleans.Alias(DeliverAsync)]
[Orleans.Concurrency.AlwaysInterleave]
public abstract ValueTask<DeliveryResult> DeliverAsync(InboxMessage message, CancellationToken cancellationToken = default(CancellationToken))
Delivers a message to this grain's inbox.

Parameters

messageInboxMessage
The received command with a required identity and payload; its receiver is this grain.
cancellationTokenCancellationToken
Cancels the caller's wait for delivery.

Returns

Result indicating delivery/processing status.

Exceptions

System.ArgumentException
message has an unset message ID, exceeds identity admission limits, or has invalid payload or headers. Optional standard metadata is validated where its contract is consumed.
System.ArgumentOutOfRangeException
The message's InboxMessage is later than the receiver's clock plus DeduplicationWindow, and the message is untracked and above the admission floor. The inbox stages nothing for it.