DirectMethodsClient.InvokeAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| InvokeAsync(String, DirectMethodServiceRequest, CancellationToken) |
Ruft eine -Methode auf einem Gerät auf. |
| InvokeAsync(String, String, DirectMethodServiceRequest, CancellationToken) |
Ruft eine -Methode für ein Modul auf. |
InvokeAsync(String, DirectMethodServiceRequest, CancellationToken)
Ruft eine -Methode auf einem Gerät auf.
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)Parameter
- deviceId
- String
Der Gerätebezeichner für das Zielgerät.
- directMethodRequest
- DirectMethodServiceRequest
Parameter zum Ausführen einer direkten Methode auf dem Gerät.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, um den Vorgang abzubrechen.
Gibt zurück
Die direkte Methodenantwort.
Ausnahmen
Wenn das bereitgestellte deviceId oder directMethodRequest null ist.
Wird ausgelöst, wenn leer deviceId oder leer ist.
Wird ausgelöst, wenn IoT Hub auf die Anforderung mit einem nicht erfolgreichen status-Code geantwortet hat. Wenn beispielsweise die bereitgestellte Anforderung gedrosselt wurde, IotHubServiceException wird mit ThrottlingException ausgelöst. Eine vollständige Liste möglicher Fehlerfälle finden Sie unter IotHubServiceErrorCode.
Wenn die HTTP-Anforderung aufgrund eines zugrunde liegenden Problems fehlschlägt, z. B. Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung.
Wenn der bereitgestellte cancellationToken einen Abbruch angefordert hat.
Gilt für:
InvokeAsync(String, String, DirectMethodServiceRequest, CancellationToken)
Ruft eine -Methode für ein Modul auf.
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)Parameter
- deviceId
- String
Der Gerätebezeichner für das Zielgerät.
- moduleId
- String
Der Modulbezeichner für das Zielmodul.
- directMethodRequest
- DirectMethodServiceRequest
Parameter zum Ausführen einer direkten Methode für das Modul.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, um den Vorgang abzubrechen.
Gibt zurück
Die direkte Methodenantwort.
Ausnahmen
Wenn das bereitgestellte deviceId oder oder moduleIddirectMethodRequest NULL ist.
Wird ausgelöst, wenn oder deviceIdmoduleId leer oder leer ist.
Wird ausgelöst, wenn IoT Hub auf die Anforderung mit einem nicht erfolgreichen status-Code geantwortet hat. Wenn beispielsweise die bereitgestellte Anforderung gedrosselt wurde, IotHubServiceException wird mit ThrottlingException ausgelöst. Eine vollständige Liste möglicher Fehlerfälle finden Sie unter IotHubServiceErrorCode.
Wenn die HTTP-Anforderung aufgrund eines zugrunde liegenden Problems fehlschlägt, z. B. Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung.
Wenn der bereitgestellte cancellationToken einen Abbruch angefordert hat.
Gilt für:
Azure SDK for .NET
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für