Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function creates a cookie associated with the specified URL.

Syntax 

BOOL InternetSetCookie(
  LPCTSTR 
lpszUrl, 
  LPCTSTR 
lpszCookieName, 
  LPCTSTR 
lpszCookieData
);

Parameters

lpszUrl

[in] Address of a null-terminated string that specifies the URL for which the cookie should be set.

lpszCookieName

[in] Address of a string that contains the name to associate with the cookie data. If this parameter is NULL, no name is associated with the cookie.

lpszCookieData

[in] Address of the actual data to associate with the URL.

Return Value

Returns TRUE if successful, or FALSE otherwise.

Remarks

Persistent cookies, which have an expiration date, are stored in the location specified in the HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Foldersregistry key. The default location is Windows\Profiles\Guest\Cookies. Session cookies, which do not have an expiration date, are stored in memory and are available only to the process in which they were created.

Creating a new cookie might cause a dialog box to appear on the screen if the appropriate registry value, AllowCookies, is set. There is no way to change the registry value from a WinInet function in Windows Embedded CE.

Requirements

Header wininet.h
Library wininet.lib
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also