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 或全局对象的构造函数和析构函数中安全地调用此函数。

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

注意

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

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW

PrivacySetZonePreferenceW