InternetEnumPerSiteCookieDecisionA 函数 (winineti.h)
检索为其设置了特定于站点的 Cookie 法规的网站的域和 Cookie 设置。
语法
BOOL InternetEnumPerSiteCookieDecisionA(
[out] LPSTR pszSiteName,
[in, out] unsigned long *pcSiteNameSize,
[out] unsigned long *pdwDecision,
[in] unsigned long dwIndex
);
参数
[out] pszSiteName
接收指定网站域的字符串的 LPSTR 。
[in, out] pcSiteNameSize
指向无符号 long 的指针,指定调用 InternetEnumPerSiteCookieDecision 函数时提供给它的 pcSiteNameSize 参数的大小。 当 InternetEnumPerSiteCookieDecision 返回时, pcSiteNameSize 接收 pszSiteName 中返回的域字符串的实际长度。
[out] pdwDecision
指向接收对应于 pszSiteName 的 InternetCookieState 枚举值的无符号 long 的指针。
[in] dwIndex
一个无符号长,指定要检索的网站索引和相应的 Cookie 设置。
返回值
如果函数检索给定域的 Cookie 设置,则为 TRUE;否则为 false。 FALSE。
注解
最初应使用 dwIndex 等于 0 调用 InternetEnumPerSiteCookieDecision。 递增 dwIndex 参数逐步完成网站和 Cookie 设置的列表。 当 InternetEnumPerSiteCookieDecision 返回 FALSE 并生成 wininet 错误 时,将到达列表的末尾,ERROR_NO_MORE_ITEMS。
与 WinINet API 的所有其他方面一样,无法从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。
注意
winineti.h 标头将 InternetEnumPerSiteCookieDecision 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winineti.h (包括 Wininet.h、Winineti.h) |
Library | Wininet.lib |
DLL | Wininet.dll |
另请参阅
InternetClearAllPerSiteCookieDecisions
InternetGetPerSiteCookieDecision