InternetSetCookieExA 函数 (wininet.h)
InternetSetCookieEx 函数创建具有与指定 URL 关联的指定名称的 Cookie。 此函数与 InternetSetCookie 函数的不同之处在于能够创建第三方 Cookie。
语法
DWORD InternetSetCookieExA(
[in] LPCSTR lpszUrl,
[in] LPCSTR lpszCookieName,
[in] LPCSTR lpszCookieData,
[in] DWORD dwFlags,
[in] DWORD_PTR dwReserved
);
参数
[in] lpszUrl
指向以 null 结尾的字符串的指针,该字符串包含应为其设置 Cookie 的 URL。
如果此指针为 NULL, InternetSetCookieEx 将 失败并 出现ERROR_INVALID_PARAMETER 错误。
[in] lpszCookieName
指向以 null 结尾的字符串的指针,该字符串包含要与此 Cookie 关联的名称。 如果此指针为 NULL,则不会与 Cookie 关联任何名称。
[in] lpszCookieData
指向以 null 结尾的字符串的指针,该字符串包含要与新 Cookie 关联的数据。
如果此指针为 NULL, InternetSetCookieEx 将 失败并 出现ERROR_INVALID_PARAMETER 错误。
[in] dwFlags
控制函数如何检索 Cookie 数据的标志:
[in] dwReserved
NULL,或包含指向要与 Cookie 关联的 Platform-for-Privacy-Protection (P3P) 标头的指针。
返回值
如果成功,则返回 InternetCookieState 枚举的成员;如果函数失败,则返回 FALSE 。 失败时,如果对 GetLastError 的调用返回ERROR_NOT_ENOUGH_MEMORY,则系统内存不足。
注解
注意
wininet.h 标头将 InternetSetCookieEx 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | wininet.h |
Library | Wininet.lib |
DLL | Wininet.dll |