HTTPCookieManage (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / HTTP functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HTTPCookieManage (Function)

In french: HTTPCookieGère

Enables or disables the management of cookies in an HTTP request run:

by the HTTPRequest function.
by the HTTPSend or RESTSend function.

Note Cookies read and sent by the HTTPRequest function are only stored in the application's memory. They are not related to the cookies of Web browsers installed on the computer.

Example

// Gère les cookies dans les requêtes sur les sites du domaine "google.fr"
HTTPCookieManage(".google.fr", True)

// Ouverture de la page d'accueil de Google
HTTPRequest("www.google.fr")

// Refait la requête en tenant compte des cookies éventuellement renvoyés au 1er appel
HTTPRequest("www.google.fr/search?hl=fr&source=hp&q=windev")

Syntax

Enabling/Disabling the management of cookies (HTTPRequest) Hide the details

HTTPCookieManage([<Domain>, ] <Activation>)

<Domain>: Character string

Domain onto which the activation or the deactivation is applied.

<Activation>: Boolean

True to enable the management of cookies,
False to disable the management of cookies.
Even if the management of cookies is disabled, you still have the ability to pass cookies in the HTTP request by using the appropriate header in HTTPRequest. Similarly, the cookies returned by the server can be retrieved by HTTPGetResult.

Enabling/Disabling the management of cookies (HTTPSend) Hide the details

HTTPCookieManage(<HTTP request> [, <Domain>] , <Activation>)

<HTTP request>: httpRequest variable

Name of the httpRequest variable for which the management of cookies will be enabled or disabled.

<Domain>: Character string

Domain onto which the activation or the deactivation is applied.

<Activation>: Boolean

True to enable the management of cookies,
False to disable the management of cookies.
Even if the management of cookies is disabled, you still have the ability to pass cookies in the HTTP request by using the appropriate header in the httpRequest variable.

Remarks

The cookies are not kept between two runs of an executable. They must be saved and restored through programming:
- backup: functions HTTPCookieGet, Serialize and fSaveText
- restoration: functions HTTPCookieReplace, Deserialize and fLoadText.
HTTPGetResult ignores HTTPCookieManage.
When the cookies are enabled:
- the cookies received in response to a call to HTTPRequest are stored while waiting for a future call to HTTPRequest on the same domain. This operating mode is similar to the one of the Internet browsers.
- cookies received in response to a call to the HTTPSend function are stored pending a subsequent call to the HTTPSend function on the same domain: the httpRequest type variable is updated. This operating mode is similar to the one of the Internet browsers.
- cookies received in response to a call to the RESTSend function are stored pending a subsequent call to the RESTSend function on the same domain: the restRequest type variable is updated. This operating mode is similar to the one of the Internet browsers.
The use of cookies is required on some sites that use them to supply the identifiers. Then, these identifiers are transmitted to each request (a basket identifier when placing an order for example).
If a management is defined on a domain, this information has priority over the global option.

Component: wd300com.dll