HTTPCookieManage (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Communication

HTTP functions

Prefix syntax

HTTPCookieManage

Presentation

Example

See also

HTTPCookieManage (Function)

In french: HTTPCookieGère

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

by the HTTPRequest function.

Remark: The cookies read and sent by HTTPRequest are only stored in memory in the application. They are not related to the cookies of Web browsers installed on the computer.

Example

// Manages the cookies in the requests on the sites of the "google.fr" domain
HTTPCookieManage(".google.fr", True)

// Open the home page of Google
HTTPRequest("www.google.com")

// Re-runs the request while taking into account the cookies possibly returned during the 1st call
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.

Remarks

The cookies are not kept between two runs of an executable. They must be saved and restored through programming:
- backup: HTTPCookieGet, Serialize and fSaveText
- restore: 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.
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: wd280com.dll