InternetEnumPerSiteCookieDecision function

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

See also

Reference

InternetSetPerSiteCookieDecision

InternetGetPerSiteCookieDecision