RenderingSession.RenewAsync(RenderingSessionUpdateOptions) 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.
Updates die Sitzungsparameter für diese Renderingsitzung.
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)Parameter
- updateOptions
- RenderingSessionUpdateOptions
Die neuen zu verwendenden Parameter
Gibt zurück
Eine Aufgabe mit einem Ergebniskontext, der Erfolgsinformationen enthält. Die zurückgegebene Aufgabe wird in einem beliebigen Thread abgeschlossen.
Hinweise
Einzelheiten dazu finden Sie unter RenderingSessionUpdateOptions.
Da es sich bei dem zugrunde liegenden Aufruf um einen REST-Aufruf handelt, sollte es zwischen nachfolgenden Aufrufen eine ausreichende Verzögerung (5-10 Sekunden) geben, um eine Serverdrosselung zu vermeiden. Bei einer Drosselung schlägt die Funktion fehl, und httpResponseCode meldet code 429 ("zu viele Anforderungen").
* Ein InvalidParam Fehler tritt auf, wenn die Renderingdienst-URL leer war, weil die Kontodomäne und die Konto-ID nicht angegeben wurden oder wenn der MaxLeaseTimeMinutes-Wert ungültig war. Er muss größer als der aktuelle Wert von maxLeaseTimeMinutes sein. * Ein AuthenticationFailed Fehler tritt auf, wenn die Anforderung nicht authentifiziert werden konnte. * Ein NotInitialized Fehler tritt auf, wenn remoteRenderingClient nicht initialisiert wurde. * Ein TooManyRequests Fehler tritt auf, wenn das Ratenlimit überschritten wurde. Wiederholen Sie die Anforderung nach der im Retry-After-Header angegebenen Dauer. * Ein DomainUnreachable Fehler tritt auf, wenn die Remoterenderingdomäne nicht erreichbar ist. Die URL ist möglicherweise ungültig, oder Azure Remote Rendering wird in dieser Region nicht unterstützt. * Ein ConnectionRefused Fehler tritt auf, wenn die Remoterenderingverbindung vom Zielhost abgelehnt wird. * Ein ConnectionFailed Fehler tritt auf, wenn die Remoterenderingverbindung fehlgeschlagen ist. Der genaue Grund ist unbekannt. * Ein Timeout Fehler tritt auf, wenn bei der Remoterenderingverbindung ein Timeout aufgetreten ist.