InternetEnumPerSiteCookieDecisionA
A version of this page is also available for
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
| Header | wininet.h |
| Library | wininet.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |