InternetEnumPerSiteCookieDecision function

Article
08/15/2017

Retrieves the domains and cookie settings of Web sites that have site-specific cookie regulations.

Syntax

BOOL InternetEnumPerSiteCookieDecision(
  _Out_   LPSTR         pszSiteName,
  _Inout_ unsigned long *pcSiteNameSize,
  _Out_   unsigned long *pdwDecision,
  _In_    unsigned long dwIndex
);

Parameters

pszSiteName [out]
A LPSTR that receives a string specifying a Web site domain.
pcSiteNameSize [in, out]
A pointer to an unsigned long that, on function call, specifies the size of the pcSiteNameSize parameter provided; and on function return, pcSiteNameSize receives the actual length of the domain string returned in pszSiteName.
pdwDecision [out]
A pointer to an unsigned long that receives the InternetCookieState enumeration value corresponding to pszSiteName.
dwIndex [in]
An unsigned long that specifies the index of the Web site and corresponding cookie setting to retrieve.

Return value

Returns TRUE if the function retrieved the cookie setting for the given domain, and FALSE otherwise.

Remarks

InternetEnumPerSiteCookieDecision should be initially called with dwIndex equal to zero. Increment the dwIndex parameter to step through the list of Web sites and cookie settings. The end of the list is reached when InternetEnumPerSiteCookieDecision returns FALSE and produces the wininet error, ERROR_NO_MORE_ITEMS.

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows 2000 Server
Product	Internet Explorer 6
Header	Wininet.h
Library	Wininet.lib
DLL	Wininet.dll
Unicode and ANSI names	InternetEnumPerSiteCookieDecisionW (Unicode) and InternetEnumPerSiteCookieDecisionA (ANSI)

Share via