InternetEnumPerSiteCookieDecisionA

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves the domains and cookie settings of Web sites for which site-specific cookie regulations are set.

Syntax

BOOL InternetEnumPerSiteCookieDecisionA(
  LPSTR pszSiteName,
  unsigned long *pcSiteNameSize,
  unsigned long *pdwDecision,
  unsigned long dwIndex
);

Parameters

• pszSiteName
  [out] LPSTR that receives a string that specifies a Web site domain.

• pcSiteNameSize
  [in, out] Pointer to an unsigned long that specifies the size of the pcSiteNameSize parameter provided to InternetEnumPerSiteCookieDecisionA when it is called. When InternetEnumPerSiteCookieDecisionA returns, pcSiteNameSize receives the actual length of the domain string returned in pszSiteName.

• pdwDecision
  [out] Pointer to an unsigned long that receives the InternetCookieState enumeration value corresponding to pszSiteName.

• dwIndex
  [in] 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

InternetEnumPerSiteCookieDecisionA should be initially called with dwIndex equal to 0. To step through the list of Web sites and cookie settings, increment the dwIndex parameter . The end of the list is reached when this function returns FALSE and returns the WinInet error, ERROR_NO_MORE_ITEMS.

Use this function for the ANSI implementation. If you call the Unicode implementation, use the InternetEnumPerSiteCookieDecisionW.

Requirements

See Also

Reference

WinInet Functions

Concepts

Platform for Privacy Preferences (P3P)