DeviceMessageLockLostException Class

Definition

Namespace:

Microsoft.Azure.Devices.Client.Exceptions

Assembly:

Microsoft.Azure.Devices.Client.dll

Package:

Microsoft.Azure.Devices.Client v1.41.2

This exception is thrown when attempting to reject/abandon/complete a cloud-to-device message with a lock token that has already expired. The lock token expires after the lock timeout set by the service, or if your client connection was lost and regained while receiving the message but before you could reject/abandon/complete it.

[System.Serializable]
public class DeviceMessageLockLostException : Microsoft.Azure.Devices.Client.Exceptions.IotHubException

[<System.Serializable>]
type DeviceMessageLockLostException = class
    inherit IotHubException

Public Class DeviceMessageLockLostException
Inherits IotHubException

Inheritance

Exception

IotHubException

DeviceMessageLockLostException

Attributes

SerializableAttribute

Remarks

An abandoned message will be re-enqueued in the per-device/module queue, and the DeviceClient instance will receive it again. A rejected message will be deleted from the queue and not received again by the device. For more information on the cause for this error and how to resolve, see https://docs.microsoft.com/azure/iot-hub/iot-hub-troubleshoot-error-412002-devicemessagelocklost. For more information on cloud-to-device message lifecycle, see https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#the-cloud-to-device-message-life-cycle.

Constructors

DeviceMessageLockLostException()	Initializes a new instance of the class.
DeviceMessageLockLostException(SerializationInfo, StreamingContext)	Initializes a new instance of the class with the specified serialization and context information.
DeviceMessageLockLostException(String)	Initializes a new instance of the class with the message string containing the device identifier that could not be found.
DeviceMessageLockLostException(String, Exception)	Initializes a new instance of the class with the message string containing the device identifier that could not be found.
DeviceMessageLockLostException(String, Guid)	Initializes a new instance of the class with the message string containing the device identifier that could not be found.

Properties

IsTransient	Indicates if the error is transient and should be retried. (Inherited from IotHubException)
TrackingId	The service returned tracking Id associated with this particular error. (Inherited from IotHubException)

Methods

GetObjectData(SerializationInfo, StreamingContext)

Sets the SerializationInfo with information about the exception. Use this to set IsTransient and TrackingId to the serialized object data. (Inherited from IotHubException)