InternetEnumPerSiteCookieDecisionA 函数（wininet.h）

项目
11/20/2024

检索为其设置了特定于网站的 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

指向未签名的长指针，指定调用 internetEnumPerSiteCookieDecision 函数时提供给 InternetEnumPerSiteCookieDecision 函数的 pcSiteNameSize 参数的大小。 InternetEnumPerSiteCookieDecision 返回时，pcSiteNameSize 接收 pszSiteName中返回的域字符串的实际长度。

[out] pdwDecision

指向接收 InternetCookieState 枚举值（对应于 pszSiteName）的无符号长指针。

[in] dwIndex

一个无符号的长，指定要检索的网站索引和相应的 Cookie 设置。

返回值

如果函数检索了给定域的 Cookie 设置，则为 true;否则为 false。 FALSE。

言论

InternetEnumPerSiteCookieDecision 最初应调用 dwIndex 等于 0。递增 dwIndex 参数步骤，遍历网站和 Cookie 设置列表。当 internetEnumPerSiteCookieDecision 返回 FALSE 并生成 wininet 错误 ERROR_NO_MORE_ITEMS时，将到达列表的末尾。

与 WinINet API 的其他所有方面一样，不能从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。

注意 WinINet 不支持服务器实现。此外，不应从服务使用它。对于服务器实现或服务，请使用 Microsoft Windows HTTP 服务（WinHTTP）。

注意

wininet.h 标头将 InternetEnumPerSiteCookieDecision 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	wininet.h （包括 Wininet.h、Winineti.h）
库	Wininet.lib
DLL	Wininet.dll