Microsoft Windows CE 3.0  

InternetGetCookie

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.

This function retrieves the cookie for the specified URL.

BOOL InternetGetCookie (
LPCTSTR
lpszUrl
,
LPCTSTR
lpszCookieName
,
LPSTR
lpCookieData
,
LPDWORD
lpdwSize
);

Parameters

lpszUrl
[in] Address of a string that contains the URL to get cookies for.
lpszCookieName
[in] Address of a string that contains the name of the cookie to get for the specified URL. This has not been implemented in this release.
lpCookieData
[out] Address of the buffer that receives the cookie data. This value can be NULL.
lpdwSize
[in] [out] Address of an unsigned long integer variable that specifies the size of the lpszCookieDatabuffer. If the function succeeds, the buffer receives the amount of data copied to the lpszCookieDatabuffer. If lpszCookieDatais NULL, this parameter receives a value that specifies the size of the buffer necessary to copy all the cookie data.

Return Values

Returns TRUE if successful, or FALSE otherwise.

Remarks

This function does not require a call to InternetOpen. This function checks in the windows\cookies directory for persistent cookies that have an expiration date set sometime in the future. This function also searches memory for any session cookies (cookies that do not have an expiration date) that were created in the same process by InternetSetCookie, since these cookies are not written to any files. Rules for creating cookie files are internal to Win32 Internet functions and might change in the future.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.12 and later Wininet.h   Wininet.lib
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

InternetOpen, InternetSetCookie