DirectMethodsClient.InvokeAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
InvokeAsync(String, DirectMethodServiceRequest, CancellationToken) |
Invoca um método em um dispositivo. |
InvokeAsync(String, String, DirectMethodServiceRequest, CancellationToken) |
Invoca um método em um módulo. |
InvokeAsync(String, DirectMethodServiceRequest, CancellationToken)
Invoca um método em um dispositivo.
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)
Parâmetros
- deviceId
- String
O identificador de dispositivo para o dispositivo de destino.
- directMethodRequest
- DirectMethodServiceRequest
Parâmetros para executar um método direto no dispositivo.
- cancellationToken
- CancellationToken
Um token de cancelamento para cancelar a operação.
Retornos
A resposta do método direto.
Exceções
Quando o fornecido deviceId
ou directMethodRequest
for nulo.
Gerado se o deviceId
estiver vazio ou espaço em branco.
Gerado se o Hub IoT respondeu à solicitação com um código de status não bem-sucedido. Por exemplo, se a solicitação fornecida foi limitada, IotHubServiceException com ThrottlingException é lançada. Para obter uma lista completa de possíveis casos de erro, consulte IotHubServiceErrorCode.
Se a solicitação HTTP falhar devido a um problema subjacente, como conectividade de rede, falha de DNS ou validação de certificado do servidor.
Se o fornecido cancellationToken
tiver solicitado o cancelamento.
Aplica-se a
InvokeAsync(String, String, DirectMethodServiceRequest, CancellationToken)
Invoca um método em um módulo.
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)
Parâmetros
- deviceId
- String
O identificador de dispositivo para o dispositivo de destino.
- moduleId
- String
O identificador do módulo de destino.
- directMethodRequest
- DirectMethodServiceRequest
Parâmetros para executar um método direto no módulo.
- cancellationToken
- CancellationToken
Um token de cancelamento para cancelar a operação.
Retornos
A resposta do método direto.
Exceções
Quando o fornecido deviceId
ou moduleId
ou directMethodRequest
é nulo.
Gerado se o deviceId
ou moduleId
estiver vazio ou espaço em branco.
Gerado se o Hub IoT respondeu à solicitação com um código de status não bem-sucedido. Por exemplo, se a solicitação fornecida foi limitada, IotHubServiceException com ThrottlingException é lançada. Para obter uma lista completa de possíveis casos de erro, consulte IotHubServiceErrorCode.
Se a solicitação HTTP falhar devido a um problema subjacente, como conectividade de rede, falha de DNS ou validação de certificado do servidor.
Se o fornecido cancellationToken
tiver solicitado o cancelamento.
Aplica-se a
Azure SDK for .NET