RenderingSession.RenewAsync(RenderingSessionUpdateOptions) 方法

定義

命名空間:

Microsoft.Azure.RemoteRendering

組件:

RemoteRenderingClientCS.dll

更新此轉譯會話的會話參數。

public:
 System::Threading::Tasks::Task<Microsoft::Azure::RemoteRendering::SessionContextResult ^> ^ RenewAsync(Microsoft::Azure::RemoteRendering::RenderingSessionUpdateOptions updateOptions);

public System.Threading.Tasks.Task<Microsoft.Azure.RemoteRendering.SessionContextResult> RenewAsync (Microsoft.Azure.RemoteRendering.RenderingSessionUpdateOptions updateOptions);

member this.RenewAsync : Microsoft.Azure.RemoteRendering.RenderingSessionUpdateOptions -> System.Threading.Tasks.Task<Microsoft.Azure.RemoteRendering.SessionContextResult>

Public Function RenewAsync (updateOptions As RenderingSessionUpdateOptions) As Task(Of SessionContextResult)

參數

updateOptions

RenderingSessionUpdateOptions

要使用的新參數

傳回

Task<SessionContextResult>

包含成功資訊的結果內容的工作。 傳回的工作會在任意執行緒中完成。

備註

如需詳細資訊，請參閱＜RenderingSessionUpdateOptions＞。

由於基礎呼叫是 REST 呼叫，因此後續呼叫之間應該有足夠的延遲 (5-10s) ，以避免伺服器節流。 如果節流，函式將會失敗，而 HttpResponseCode 會報告程式碼 429 (「要求太多」) 。

InvalidParam* 如果轉譯服務 URL 是空的，因為未提供帳戶網域和帳戶識別碼，或 maxLeaseTimeMinutes 值無效，就會發生錯誤。 它必須大於 maxLeaseTimeMinutes 的目前值。 AuthenticationFailed* 如果無法驗證要求，就會發生錯誤。 NotInitialized* 如果未初始化 RemoteRenderingClient，就會發生錯誤。 TooManyRequests* 如果超過速率限制，就會發生錯誤。 在 Retry-After 標頭中指定的持續時間之後重試要求。 DomainUnreachable* 如果無法連線到遠端轉譯網域，就會發生錯誤。 URL 可能無效，或此區域中不支援 Azure 遠端轉譯。 ConnectionRefused* 如果目的地主機拒絕遠端轉譯連線，就會發生錯誤。 ConnectionFailed* 如果遠端轉譯連線失敗，就會發生錯誤。 確切的原因不明。 Timeout* 如果遠端轉譯連線逾時，就會發生錯誤。