Export (0) Print
Expand All
Expand Minimize

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.

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wininet.h

Library

Wininet.lib

DLL

Wininet.dll

Unicode and ANSI names

InternetEnumPerSiteCookieDecisionW (Unicode) and InternetEnumPerSiteCookieDecisionA (ANSI)

See also

InternetClearAllPerSiteCookieDecisions
InternetGetPerSiteCookieDecision
InternetSetPerSiteCookieDecision
PrivacyGetZonePreferenceW
PrivacySetZonePreferenceW

 

 

Show:
© 2014 Microsoft