SetCookie Event

Fired for every cookie set by the server.

Syntax

typedef void __fastcall (__closure *TipwJSONSetCookieEvent)(System::TObject* Sender, TipwJSONSetCookieEventParams *e);

__property TipwJSONSetCookieEvent OnSetCookie = {read=FOnSetCookie, write=FOnSetCookie};

typedef struct {
     String Name;
     String Value;
     String Expires;
     String Domain;
     String Path;
     bool Secure;
} TipwJSONSetCookieEventParams;

Remarks

The SetCookie event is fired for every "Set-Cookie:" header received from the HTTP server.

The Name parameter contains the name of the cookie, with the corresponding value supplied in the Value parameter.

The Expires parameter contains an expiration time for the cookie (if provided by the server). The time format used is "Weekday, DD-Mon-YY HH:MM:SS GMT". If the server does not provide an expiration time, the Expires parameter will be an empty string. In this case, the convention is to drop the cookie at the end of the session.

The Domain parameter contains a domain name to limit the cookie to (if provided by the server). If the server does not provide a domain name, the Domain parameter will be an empty string. The convention in this case is to use the server specified in the URL (URLServer) as the cookie domain.

The Path parameter contains a path name to limit the cookie to (if provided by the server). If the server does not provide a cookie path, the Path parameter will be an empty string. The convention in this case is to use the path specified in the URL (URLPath) as the cookie path.

The Secure parameter specifies whether the cookie is secure. If the value of this parameter is True, the cookie value must be submitted through a secure (HTTPS) connection only.