TsgcHTTP3Client › Methoden › SetMaxPushId

SetMaxPushId Methode

Sendet einen MAX_PUSH_ID-Frame, der die höchste Push-ID anhebt, die der Client akzeptieren wird.

Syntax

procedure SetMaxPushId(aMaxPushId: Int64);

Parameter

NameTypBeschreibung
aMaxPushIdInt64Höchste Push-ID, die der Server verwenden darf. Übergeben Sie 0, um einen einzelnen Push zuzulassen (Push-ID 0), oder einen höheren Wert, um mehr zuzulassen.

Rückgabewert

Keine.

Hinweise

SetMaxPushId sendet einen MAX_PUSH_ID-Frame auf dem Control-Stream des Clients, wie in RFC 9114 Abschnitt 7.2.7 definiert. Server Push ist deaktiviert, bis der Client diesen Frame sendet, denn ein Server darf nur mit einer ID pushen, die kleiner oder gleich dem vom Client angekündigten Wert ist. Rufen Sie sie auf, um Server Push zu aktivieren.

Der Wert ist kumulativ und darf über die Lebensdauer der Verbindung hinweg nur wachsen: Ein Server behandelt ein MAX_PUSH_ID, das die Grenze senkt, als Verbindungsfehler. Um einen einzelnen, bereits zugesagten Push zu stoppen, verwenden Sie stattdessen CancelPush.

Die Methode kann vor Connect aufgerufen werden. Wenn der Kontroll-Stream noch nicht offen ist, wird der Wert gespeichert und der Frame automatisch gesendet, sobald die Verbindung hergestellt wurde.

Beispiel



oClient.OnPush := OnPushEvent;

// accept pushes with ids 0..9

oClient.SetMaxPushId(9);

oClient.Connect('www.example.com', 443);

Zurück zu Methoden