RenderingSession.RenewAsync(RenderingSessionUpdateOptions) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Aktualizacje parametrów sesji dla tej sesji renderowania.
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)Parametry
- updateOptions
- RenderingSessionUpdateOptions
Nowe parametry do użycia
Zwraca
Zadanie z kontekstem wyniku zawierającym informacje o powodzeniu. Zwrócone zadanie zostanie ukończone w dowolnym wątku.
Uwagi
Aby uzyskać szczegółowe informacje, zobacz opis funkcji RenderingSessionUpdateOptions.
Ponieważ wywołanie podstawowe jest wywołaniem REST, powinno istnieć wystarczające opóźnienie (5–10s) między kolejnymi wywołaniami, aby uniknąć ograniczania przepustowości serwera. W przypadku ograniczania funkcja zakończy się niepowodzeniem, a kod HttpResponseCode zgłasza kod 429 ("zbyt wiele żądań").
* Błąd InvalidParam występuje, jeśli adres URL usługi renderowania był pusty, ponieważ nie podano domeny konta i identyfikatora konta lub jeśli wartość maxLeaseTimeMinutes jest nieprawidłowa. Musi być większa niż bieżąca wartość parametru maxLeaseTimeMinutes. * Błąd AuthenticationFailed występuje, jeśli nie można uwierzytelnić żądania. * Błąd NotInitialized występuje, jeśli element RemoteRenderingClient nie został zainicjowany. * Błąd TooManyRequests występuje, jeśli limit szybkości został przekroczony. Ponów próbę żądania po upływie czasu trwania podanego w nagłówku Retry-After. * Błąd DomainUnreachable występuje, jeśli domena renderowania zdalnego jest niemożliwa do osiągnięcia. Adres URL może być nieprawidłowy lub usługa Azure Remote Rendering nie jest obsługiwana w tym regionie. * Błąd ConnectionRefused występuje, jeśli połączenie zdalnego renderowania jest odrzucane przez hosta docelowego. * Błąd ConnectionFailed występuje, jeśli połączenie zdalnego renderowania nie powiodło się. Dokładna przyczyna jest nieznana. * Błąd Timeout występuje, jeśli upłynął limit czasu połączenia zdalnego renderowania.