IotHubBaseClient.SetDesiredPropertyUpdateCallbackAsync Method

Reference

Definition

Namespace:: Microsoft.Azure.Devices.Client

Assembly:: Microsoft.Azure.Devices.Client.dll

Package:: Microsoft.Azure.Devices.Client v2.0.0-preview002

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Set a callback that will be called whenever the client receives a desired state update from the service. The client instance must be opened already.

public System.Threading.Tasks.Task SetDesiredPropertyUpdateCallbackAsync (Func<Microsoft.Azure.Devices.Client.DesiredProperties,System.Threading.Tasks.Task> callback, System.Threading.CancellationToken cancellationToken = default);

member this.SetDesiredPropertyUpdateCallbackAsync : Func<Microsoft.Azure.Devices.Client.DesiredProperties, System.Threading.Tasks.Task> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SetDesiredPropertyUpdateCallbackAsync (callback As Func(Of DesiredProperties, Task), Optional cancellationToken As CancellationToken = Nothing) As Task

Parameters

callback: Func<DesiredProperties,Task>

The callback to be invoked when a desired property update is received from the service.

cancellationToken: CancellationToken

A cancellation token to cancel the operation.

Returns

Task

Exceptions

OperationCanceledException

Thrown when the operation has been canceled.

Remarks

Calling this API more than once will result in the callback set last overwriting any previously set callback. A method callback can be unset by setting callback to null.

This has the side-effect of subscribing to the PATCH topic on the service.

Applies to