InternetSetCookie Function

---

Creates a cookie associated with the specified URL.

Syntax

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

The actual syntax of this function varies between its ANSI and Unicode implementations. For more information, see Win32 Internet Functions Syntax.

Parameters

lpszUrl

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

lpszCookieName

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

Address of the actual data to associate with the URL.

Return Value

Returns TRUE if successful, or FALSE otherwise. To get a specific error message, call GetLastError.

Remarks

Cookies created by InternetSetCookie without an expiration date are stored in memory and are available only in the same process that created them. Cookies that include an expiration date are stored in the windows\cookies directory.

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 Win32® Internet function.

Function Information

Windows NT	Use version 4.0. Implemented as ANSI and Unicode functions.
Windows	Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header	Wininet.h
Import library	Wininet.lib
Minimum availability	Internet Explorer 3.0 (ANSI only), 5 (ANSI and Unicode)

Windows CE

Windows CE	Use version 2.12 and later. Implemented as ANSI and Unicode functions.
Minimum availability	Internet Explorer 4.0

See Also

Microsoft Win32 Internet Functions Overview, Managing Cookies, Microsoft Win32 Internet Functions Reference, Cookie Functions