Partager via


DirectMethodsClient.InvokeAsync Méthode

Définition

Surcharges

InvokeAsync(String, DirectMethodServiceRequest, CancellationToken)

Appelle une méthode sur un appareil.

InvokeAsync(String, String, DirectMethodServiceRequest, CancellationToken)

Appelle une méthode sur un module.

InvokeAsync(String, DirectMethodServiceRequest, CancellationToken)

Appelle une méthode sur un appareil.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse> InvokeAsync (string deviceId, Microsoft.Azure.Devices.DirectMethodServiceRequest directMethodRequest, System.Threading.CancellationToken cancellationToken = default);
abstract member InvokeAsync : string * Microsoft.Azure.Devices.DirectMethodServiceRequest * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse>
override this.InvokeAsync : string * Microsoft.Azure.Devices.DirectMethodServiceRequest * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse>
Public Overridable Function InvokeAsync (deviceId As String, directMethodRequest As DirectMethodServiceRequest, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DirectMethodClientResponse)

Paramètres

deviceId
String

Identificateur de l’appareil cible.

directMethodRequest
DirectMethodServiceRequest

Paramètres pour exécuter une méthode directe sur l’appareil.

cancellationToken
CancellationToken

Jeton d’annulation pour annuler l’opération.

Retours

Réponse de la méthode directe.

Exceptions

Lorsque le fourni deviceId ou directMethodRequest est null.

Levée si est deviceId vide ou espace blanc.

Levée si IoT Hub a répondu à la demande avec un code de status non réussi. Par exemple, si la requête fournie a été limitée, IotHubServiceException avec ThrottlingException est levée. Pour obtenir la liste complète des cas d’erreur possibles, consultez IotHubServiceErrorCode.

Si la requête HTTP échoue en raison d’un problème sous-jacent tel que la connectivité réseau, l’échec DNS ou la validation du certificat de serveur.

Si le fourni cancellationToken a demandé l’annulation.

S’applique à

InvokeAsync(String, String, DirectMethodServiceRequest, CancellationToken)

Appelle une méthode sur un module.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse> InvokeAsync (string deviceId, string moduleId, Microsoft.Azure.Devices.DirectMethodServiceRequest directMethodRequest, System.Threading.CancellationToken cancellationToken = default);
abstract member InvokeAsync : string * string * Microsoft.Azure.Devices.DirectMethodServiceRequest * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse>
override this.InvokeAsync : string * string * Microsoft.Azure.Devices.DirectMethodServiceRequest * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.DirectMethodClientResponse>
Public Overridable Function InvokeAsync (deviceId As String, moduleId As String, directMethodRequest As DirectMethodServiceRequest, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DirectMethodClientResponse)

Paramètres

deviceId
String

Identificateur de l’appareil cible.

moduleId
String

Identificateur du module cible.

directMethodRequest
DirectMethodServiceRequest

Paramètres pour exécuter une méthode directe sur le module.

cancellationToken
CancellationToken

Jeton d’annulation pour annuler l’opération.

Retours

Réponse de la méthode directe.

Exceptions

Lorsque le fourni deviceId ou moduleId ou directMethodRequest est null.

Levée si ou deviceIdmoduleId est vide ou espace blanc.

Levée si IoT Hub a répondu à la demande avec un code de status non réussi. Par exemple, si la requête fournie a été limitée, IotHubServiceException avec ThrottlingException est levée. Pour obtenir la liste complète des cas d’erreur possibles, consultez IotHubServiceErrorCode.

Si la requête HTTP échoue en raison d’un problème sous-jacent tel que la connectivité réseau, l’échec DNS ou la validation du certificat de serveur.

Si le fourni cancellationToken a demandé l’annulation.

S’applique à