InternetEnumPerSiteCookieDecision function

Retrieves the domains and cookie settings of websites for which site-specific cookie regulations are set.

Syntax

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

Parameters

pszSiteName [out]

An LPSTR that receives a string specifying a website domain.

pcSiteNameSize [in, out]

A pointer to an unsigned long that specifies the size of the pcSiteNameSize parameter provided to the InternetEnumPerSiteCookieDecision function when it is called. When InternetEnumPerSiteCookieDecision 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]

An unsigned long that specifies the index of the website and corresponding cookie setting to retrieve.

Return value

TRUE if the function retrieved the cookie setting for the given domain; otherwise, false. FALSE.

Remarks

InternetEnumPerSiteCookieDecision should be initially called with dwIndex equal to 0. Incrementing the dwIndex parameter steps through the list of websites and cookie settings. The end of the list is reached when InternetEnumPerSiteCookieDecision returns FALSE and produces the wininet error, ERROR_NO_MORE_ITEMS.

Like all other aspects of the WinINet API, this function cannot be safely called from within DllMain or the constructors and destructors of global objects.

Requirements

See also

InternetClearAllPerSiteCookieDecisions

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW